Guide

From install to mastery in just a few minutes

Getting Started

First Launch

1

Install & Launch

Download Workspace Container from the Mac App Store. The container window appears automatically on screen.

2

Grant Accessibility Permission

On first launch, the system will prompt for permission. Go to System Settings → Privacy & Security → Accessibility and enable Workspace Container. This is required to control other windows.

3

Bind Your First Window

Open any app (e.g. Safari, Notes) and drag its window into the container area. Or use ⌃⌥1 to bind the focused window to the first tile.

💡
Restart the app after granting permission for it to take effect. If binding doesn't work, quit and reopen Workspace Container.
Window Binding

Two Ways to Bind

🖱

Drag to Bind

The most intuitive method for mouse/trackpad users.

  • Drag an app window toward the container
  • The target tile highlights
  • Release to snap the window into place
  • Drag out of the container to unbind
⌨️

Keyboard Binding

Efficient keyboard-driven workflow.

  • Click the app window to focus it
  • Press ⌃⌥1-4
  • The window binds to the corresponding tile
  • Press the same shortcut again to unbind
Shortcuts

Keyboard Shortcuts

Shortcut Action
⌃ ⌥ 1 Bind current window to Tile 1
⌃ ⌥ 2 Bind current window to Tile 2
⌃ ⌥ 3 Bind current window to Tile 3
⌃ ⌥ 4 Bind current window to Tile 4
💡
Tile numbers depend on the current layout. For example, in vertical split, Tile 1 is the left half and Tile 2 is the right half.
Layouts

Built-in Layout Reference

1
2
Vertical Split
50/50 left-right. The classic dual-screen layout for code + browser, docs + reference, etc.
1
2
Horizontal Split
50/50 top-bottom. Great for comparing content, code + terminal, and vertical workflows.
1
2
70 / 30
Main window at 70%, sidebar at 30%. Ideal for a primary app + chat, notes, or other tools.
1
2
30 / 70
Left navigation at 30%, main content at 70%. Perfect for file manager + editor setups.
1
2
3
Three Columns
Equal thirds for parallel multitasking. Design + code + preview, or email + calendar + notes.
1
2
3
4
Quad Grid
2×2 grid with four apps at once. Great for monitoring dashboards and multi-document comparison.
💡
Switch layouts anytime from the menu bar. Click the Workspace Container icon and select the layout you need.
Sync Behavior

Container & Window Interaction

↔

Move Sync

When you drag the container window, all bound app windows maintain their relative positions and move together. Drag the entire group anywhere.

⤡

Resize Sync

When you resize the container, all bound windows automatically recalculate their positions and sizes according to the layout proportions.

—

Minimize Sync

Minimizing the container sends all bound windows to the Dock together. Restore and they all return to their original positions.

✕

Close Release

Closing the container automatically unbinds all windows. App windows stay in place and are not closed.