Guide

Zonal gives every display a Layout of Zones and puts each window in one with a single gesture. This guide shows how, and when each way of doing it pays off, so you spend your day working instead of dragging window corners. Everything fits on one printable page in the quick reference.

The idea in one minute

Windows on a Mac open wherever they like. Over a day they pile up, overlap and hide each other, and every time you want two things side by side you drag corners until they roughly fit. That is a small cost paid hundreds of times.

Zonal replaces it with a plan. You decide once how each display should be divided: a Layout made of Zones. From then on, putting a window in its place is one gesture, called a Snap: the window moves and resizes to fill the Zone exactly, with even gaps and nothing overlapping.

Three app windows overlapping each other at random sizes on the desktop.
Before: windows wherever they opened.
The same three windows side by side, each filling one Zone of the Priority Grid Layout.
After three Snaps: every window has its place.

Because the Zones stay the same, your hands learn them. After a few days you stop thinking about where windows go.

Getting started

Install

Open the downloaded zip file, move Zonal to your Applications folder, then open it from there.

First launch

The first time Zonal opens, it shows a welcome window with three steps. Zonal runs from the menu bar and has no Dock icon.

Zonal's welcome window, with the steps What Zonal does, Allow Accessibility and Try it.
The welcome window walks you through the one permission Zonal needs.
  1. What Zonal does. A short summary: hold ⇧ while you drag a window to see the Zones, then let go over one.
  2. Allow Accessibility. Zonal needs Accessibility access to move other apps’ windows. Click Open Settings, which opens Privacy & Security > Accessibility. Turn on Zonal. The status in the welcome window changes from “Not granted yet” to “Granted” by itself. You do not need to relaunch Zonal.
  3. Try it. Drag the welcome window by its title bar while you hold ⇧ (Shift), and let go over a Zone. The welcome window is the one Zonal window that Snaps.

You can reopen the welcome window at any time: choose Welcome… from the menu-bar menu.

Launch at login

The welcome window has a Start Zonal at login checkbox. It is ticked by default, and it is worth leaving on: Zonal is most useful when it is always there. You can change it later in Settings > General; both places always show the same state. If macOS asks you to approve the login item, Zonal says so and offers Open Login Items.

Zonal lives in the menu bar. The icon shows a row of three Zones. While Accessibility is missing, the icon shows a warning triangle instead. Click it to open the menu.

Zonal's menu-bar menu, open, with the Accessibility status, the License status, one submenu per display and the Zonal commands.
The menu-bar menu. Each display has its own submenu for its Layout.

Three ways to Snap

Every Snap ends the same way, so pick the gesture that suits what your hands are doing at that moment. Most people use all three.

Which way to Snap
WayHowBest when
DragHold ⇧ while you drag a window, let go over a Zone.You are already moving the window with the mouse, or you want to see the Zones while you choose.
Green buttonHold ⌘ on the green button, click a Zone in the picker.You use a trackpad and dragging is tiring, or you want to Snap without moving the window first.
Keyboard⌃⌥⇧ and a Zone number.Your hands are on the keyboard, for example right after opening a new window.

Snapping with the mouse

  1. Start dragging a window. Drag it by its title bar.
  2. Hold ⇧ Shift. An overlay appears on the display under your pointer. It shows the display’s Layout, with each Zone numbered. The Zone under the pointer is highlighted.
  3. Move over the Zone you want. If the pointer is in a gap between Zones, Zonal selects the nearest Zone. If the pointer is outside the usable area of the display, such as over the menu bar or the Dock, no Zone is selected.
  4. Release the mouse button. The window Snaps to the highlighted Zone.
Hold ⇧, drag, let go over a Zone: the window Snaps into it. The key badge in the corner shows what is held.
A window being dragged with Shift held. The overlay shows three numbered Zones and the middle one is highlighted.
Hold ⇧ during a drag and the Zones appear. Let go over the highlighted one.

If you move the pointer to another display, the overlay moves with it and shows that display’s Layout.

For your first few drags without the activation key, a small label follows the pointer to remind you which key to hold. It names the key you chose in Settings, and it goes away for good after your first Snap, or after three drags.

A small dark label next to the pointer during a drag, reading Hold Shift to snap into Zones.
The first-drag hint, shown only until you have Snapped once.

Cancel a Snap

Release ⇧ before you release the mouse button, or press esc. The overlay hides and the window stays where you drop it. Dragging without the activation key never shows the overlay. Resizing a window or selecting text never shows it either.

Span several Zones

Sometimes one window deserves more room for a while: a wide spreadsheet, a timeline, a long diff. Rather than make a new Layout, let the window cover several Zones.

Hold ⇧⌃ (Shift and ⌃ Control) while you drag. Every Zone the pointer crosses is added to the selection. When you release the mouse button, the window fills the smallest rectangle that contains all the selected Zones, including the gaps between them.

Add ⌃ and every Zone you cross joins the selection. The window fills them all.
A window being dragged with Shift and Control held across a 3 Columns Layout. Zones 2 and 3 are both highlighted.
With ⌃ added, every Zone you cross joins the selection.

If you release ⌃ before the mouse button, the selection collapses to the Zone under the pointer. Spanning is limited to one display: if the pointer enters another display, the selection starts over.

Change the activation key

The activation key is ⇧ by default. To change it, open Settings > General.

To span, hold ⌃ together with the activation key (⌥⌃ or ⌘⌃). With Always show Zones on, ⌃ alone spans. The span key cannot be changed.

Snapping from the green button

Hold ⌘ (Command) and rest the pointer on a window’s green button. After a moment, the Zone picker opens under the button: a miniature of the display’s Layout, with the same Zone numbers and the Layout’s name as a caption.

Hold ⌘ on the green button, point at a Zone to preview it, click to Snap.
The Zone picker open under a window's green button, showing a miniature Layout. The pointer is on one Zone, and a preview shows where the window will land.
The Zone picker. Hovering a Zone previews where the window will land.

Without ⌘, the green button shows the macOS tile menu as usual. Windows with a custom title bar and no standard green button get no picker. To turn the picker off, clear Zone picker in Settings > General.

Snapping with the keyboard

Shortcuts act on the focused window of the frontmost app, on the display that holds the center of the window.

Default shortcuts
ShortcutAction
⌃⌥⇧1 to 9Snap the window to that numbered Zone. Nothing happens if the Layout has fewer Zones than the number.
⌃⌥⇧[Move to the previous Zone. From the first Zone, the window moves to the last. If the window is not in a Zone, it moves to the last Zone.
⌃⌥⇧]Move to the next Zone. From the last Zone, the window moves to the first. If the window is not in a Zone, it moves to the first Zone.
⌃⌥⇧`Switch the display to its next Layout. The list wraps around. Windows do not move; the new Layout applies to your next Snap.

⌃ Control, ⌥ Option, ⇧ Shift. Keys such as [, ] and ` are shown for your current keyboard layout. If your keyboard is labelled Ctrl, Alt and Win, turn on Show key names instead of symbols in Settings > General, and Zonal writes keys by name too.

Zones are numbered in reading order: top to bottom, then left to right. The numbers are the ones you see in the overlay, so a glance at it while dragging teaches you the shortcuts.

Change or clear a shortcut

Open Settings > Hotkeys. Each action has its own row: Zone 1 to Zone 9, Previous Zone, Next Zone and Next Layout.

Settings, Hotkeys tab: one row per action with its shortcut, and the Hyper and Restore defaults buttons.
Settings > Hotkeys. Click a shortcut, then press the new one.
  1. Click the shortcut.
  2. Press the new combination. The new shortcut works at once, and the old one stops.

Press esc to cancel, or delete to clear the shortcut. You can also click Clear next to it. A cleared action shows “Not set” and does nothing.

Every shortcut needs ⌃ or ⌘. macOS does not deliver a shortcut that uses only ⇧ or ⌥ as modifiers, so Zonal refuses it with “A shortcut needs ⌃ or ⌘.” Zonal also refuses a combination another Zonal action already uses, and tells you which one.

Two buttons set every shortcut at once. Hyper (⌃⌥⇧⌘) adds ⌘ to all of the default combinations; use it if you have mapped Caps Lock to a Hyper key, or if another app already takes the defaults. Restore defaults returns to the table above.

When another window manager is running

If an app such as Rectangle, Magnet or Moom is running, Settings > Hotkeys and the welcome window show a warning. macOS delivers a shortcut shared by two apps to both of them, so pick combinations the other app does not use. The warning disappears when the other app quits.

Resizing windows side by side

When two Snapped windows sit in neighbouring Zones, drag the edge where they meet and both windows resize together: the neighbour follows as you drag, so there is no gap and no overlap. Every Snapped window along that edge follows, for example two stacked windows beside a tall one. A corner drag moves the windows along both of its edges.

Drag the edge between two Snapped windows: the neighbour follows, in both directions.
Two Snapped windows side by side, each half of the display.
Two windows Snapped side by side.
The same two windows after the edge between them was dragged to the right: the left one is wider, the right one narrower, with the same gap.
Drag the edge between them: the neighbour follows.

To turn it off, clear Resize neighbouring windows together in Settings > General.

Pick a Layout for how you work

The best Layout follows two things: the shape of the display and what you do on it. Some starting points, all of which you can build in a minute (see Layouts). Zonal comes with the first five.

2 Columns: laptops

On a 13 to 16 inch screen, two windows is the most that stays readable. Work on the left, reference on the right: code and documentation, an email and the calendar, a draft and its sources.

Tip: span both Zones when one window needs the whole screen for a while.

Priority Grid: wide and ultrawide

On a wide display, the far edges are uncomfortable to read for long. Keep your main window in the center, straight ahead, and put chat, music or a terminal at the sides where a glance is enough.

Tip: it is the default for ultrawide displays.

3 Columns: 27 inch and 4K

Three equal windows for work that compares things: a design, its spec and the build; three documents; a browser, an editor and a preview.

Tip: span two columns for the window you are actively editing.

2 Rows: portrait displays

A rotated display is made for long, narrow things: logs, chat threads, a web page, a PDF. Stack two of them.

Tip: it is the default for portrait displays.

2×2 Grid: calls and dashboards

Four windows you watch more than you type in: a video call, its notes, the shared document and the chat; or four dashboards.

Agent workstation: coding with agents

Your editor on the left, one terminal per agent session in the middle, and a narrow Rail on the right. Sessions that are working move to the Rail on their own, and come back when they need you.

Build it: Columns template, then split and mark the Rail in the editor.

Layouts

A Layout is a named arrangement of Zones that covers one display. The Zones never overlap and always cover the whole display.

Zonal starts with five Layouts: Priority Grid (25/50/25 columns), 3 Columns, 2 Columns, 2 Rows and 2×2 Grid.

The Layouts window

Choose Edit Layouts… from the menu-bar menu, or click Open Layouts Window in Settings > Layouts. Your Layouts are listed on the left. Select one to change it on the right.

The Layouts window: the list of Layouts on the left, and the selected Layout's name, spacing, preview and display assignment on the right.
The Layouts window.

Name, spacing and display changes apply at once.

The full-screen editor

To change the Zones themselves, select the Layout in the Layouts window and click Edit on followed by the display’s name, for example Edit on Built-in Retina Display. The editor covers that display, so you work at real size and see exactly how big each Zone will be.

Click a Zone to split it. Undo takes the split back.
The full-screen Layout editor covering a display, with four numbered Zones and the Done and Cancel buttons.
The full-screen editor. Click to split, drag a divider to resize.

Click Done to save the Layout. Press esc or click Cancel to discard your edits and leave the Layout as it was. You return to the Layouts window either way.

Agent sessions and the Rail

A session is Busy while the agent works and needs nothing from you. It is Waiting when the agent has stopped and needs you: it finished, asks permission, or asks a question.

After a session has been Busy for 20 seconds, its window moves into the Layout’s Rail: a Zone set aside for windows that need no attention, where the window stays readable at a smaller size. The window next to the Zone it left grows into the space. When the session is Waiting, the window goes back to its Zone and the neighbour shrinks back. Nothing overlaps, and the window that comes back does not take focus, so it never interrupts what you are typing.

Editor Agent 1 Agent 2 Rail Both agents need you Busy 20 s Editor Agent 2 1 Agent 1 works in the Rail; Agent 2 gets its space Waiting Editor Agent 1 Agent 2 Agent 1 is back, without taking focus
The Rail at work: a Busy session moves aside, and comes back the moment it needs you.

Here is the same story on a real screen:

A Busy session moves to the Rail and its neighbour grows. When the session is Waiting, everything goes back. The wait is sped up here.
An editor window on the left and two terminal windows stacked in the middle, all Snapped. The narrow Rail on the right is empty.
1. Every session in its Zone.
The first terminal now sits in the narrow Rail on the right, still showing its output. The second terminal has grown to fill the whole middle column.
2. The first session has been Busy for 20 seconds: it moved to the Rail, and its neighbour grew.
Both terminals sit in the Rail, one above the other in equal slices.
3. Both sessions are Busy: they share the Rail, the oldest on top.
The first terminal is back in its Zone in the middle column, at full size.
4. The first session is Waiting: its window is back in its Zone, ready for your answer.

Set it up

  1. Add a Rail to a Layout. In the full-screen editor, right-click a Zone, often a narrow one at the side, and choose Make Rail. The Rail is drawn in orange with a dashed outline and has no number.
  2. Connect Claude Code. In Settings > General, click Connect Claude Code. Zonal adds its hooks to ~/.claude/settings.json, which applies to every session, and keeps a copy of the previous file next to it as settings.json.zonal-backup. Sessions that are already running pick up the change by themselves.
  3. Snap each terminal window to a Zone of that Layout. Zonal only moves Snapped windows, and it learns each session’s Zone from where its window is Snapped.
  4. Allow Automation. The first time a session sends a signal, macOS asks whether Zonal may control your terminal app. Zonal uses it only to ask the terminal which window runs the session. Click Allow.
The full-screen editor with a right-click menu open over a narrow Zone on the right, offering Make Rail.
Right-click a Zone in the editor and choose Make Rail.
Settings, General tab, with the Move Busy agent windows to the Rail toggle, the Claude Code button and the hook entries.
Settings > General: the Rail toggle and the Claude Code connection.

Move Busy agent windows to the Rail in Settings > General is on by default. Turn it off to pause the Rail without disconnecting Claude Code. If you prefer to edit ~/.claude/settings.json yourself, open Hook entries for ~/.claude/settings.json under the button and click Copy. Disconnect Claude Code removes Zonal’s hooks and leaves your other hooks alone.

Supported terminals: Terminal, iTerm2 and Ghostty 1.3 or later. In Ghostty, Zonal finds the window by its folder and title, so two Ghostty windows in the same folder with the same title are left alone. Terminals inside an editor, such as VS Code or Cursor, cannot be moved, since one window holds many terminals.

In the overlay, the Rail is drawn the same way and is never a drop target, the Zone shortcuts skip it, and the Zone picker does not offer it: only Busy sessions go there.

The drag overlay on a Layout with a Rail: the numbered Zones, and the Rail drawn in orange with a dashed outline and no number.
The Rail in the overlay: orange, dashed, no number.

While you work

Every window in the Rail goes back to its Zone when you turn the toggle off, disconnect Claude Code, switch or edit the display’s Layout, connect or disconnect a display, or choose Quit from the menu-bar menu. If Zonal restarts for an update or after a crash, the windows stay in the Rail, and the next signal or a click brings them back.

When a window does not move

Zonal leaves a session’s window alone unless all of these hold:

Other agents and scripts

Any agent or script can drive the Rail with Zonal’s URL scheme, for example a long build, a test run or another agent tool. Open the URL with open -g so Zonal stays in the background:

Each URL needs session, a stable id for the session, and term, the terminal’s TERM_PROGRAM: Apple_Terminal, iTerm.app or ghostty. It finds the window with tty (Terminal and iTerm2, for example ttys003), termsession (iTerm2’s ITERM_SESSION_ID) or cwd (the working folder, Ghostty). Values are URL-encoded, and Zonal ignores items it does not know. For example, to send a long build to the Rail and bring it back when it ends:

s=build-$$; t=$(tty | sed 's|/dev/||')
open -g "zonal://busy?session=$s&term=$TERM_PROGRAM&tty=$t"
make release
open -g "zonal://waiting?session=$s&term=$TERM_PROGRAM&tty=$t"

Get the most out of Zonal

Displays and Spaces

Stage Manager and macOS tiling

Stage Manager

When Stage Manager is on and its strip of recent apps is visible, Zonal leaves room for the strip: the Zones, the overlay and every Snap stay clear of it. When the strip hides itself, the Zones use the whole display. You do not need to relaunch Zonal after you turn Stage Manager on or off.

macOS window tiling

macOS can also tile a window when you drag it to a screen edge. If that setting is on, the welcome window shows a one-time tip, and Settings > General shows a note with an Open Desktop & Dock button.

You can also turn on Turn off macOS tiling while Zonal runs, in Settings > General or in the welcome window’s tip. It is off by default. While it is on, macOS does not tile windows dragged to an edge or with ⌥ held. Zonal puts your macOS settings back as they were when you turn it off or quit Zonal, and at the next launch if Zonal stopped unexpectedly. A setting you changed yourself in System Settings meanwhile is left as you set it.

When both react to a drag, Zonal wins: while the overlay is visible, Zonal Snaps the window when you release, over any macOS tile. The macOS preview may flash briefly. The default Zonal shortcuts avoid the fn⌃ shortcuts macOS uses for tiling.

Windows that cannot fill a Zone

Some windows have a fixed size or a minimum size, so they cannot match a Zone exactly. After every Snap, Zonal checks the size the window actually took. If it differs from the Zone, Zonal centers the window on the Zone, and then moves it the least amount needed to keep it fully on the display.

A window larger than the display is aligned to the top-left, so its title bar stays reachable. A window that fits the Zone is not moved a second time.

Windows that Zonal does not Snap

Zonal Snaps standard windows. It never Snaps dialogs, sheets, floating panels and palettes, windows in macOS full-screen mode, or its own windows other than the welcome window. For these windows, dragging shows no overlay and shortcuts do nothing.

Permissions

Zonal needs one permission: Accessibility, so that it can move other apps’ windows. If you use the Rail, it also asks for Automation for each terminal app, so it can find the window that runs a session. It does not need Input Monitoring or Screen Recording, and it does not show the system prompt when it launches. The first time you click Open Settings in the welcome window, macOS shows its prompt once and Zonal appears in the Accessibility list.

Updates

Zonal checks for updates automatically once a day and asks before it installs one. To check now, choose Check for Updates… from the menu-bar menu, or click Check now in Settings > Updates.

License and troubleshooting

Zonal includes a 14-day Trial with every feature. When you buy a License, paste the key from your receipt in Settings > License and click Activate. Before you move Zonal to another Mac, click Deactivate this Mac there to free one of your three Activations. For the details, see Licensing. If something does not work as described here, start with the FAQ.