Multiple Windows

Maestro can run across multiple windows so you can spread agents over more than one monitor or simply give a long-running agent its own dedicated space. Every window shares the same Left Bar agent list, but each agent is “owned” by exactly one window at a time. Maestro keeps that ownership consistent for you - an agent is never lost, duplicated, or stranded in a window you closed. Moving windows is an agent-level action: a whole agent (with all of its AI, terminal, browser, and file tabs) moves together as one unit. Individual tabs are never split across windows.

​

Creating a New Window

There are two ways to pull an agent out into a window of its own:

• Right-click the agent - Right-click the agent in the Left Bar and choose Move to Window -> New Window.
• Quick Actions - Open Quick Actions (Cmd+K) and search for move to window, then pick Move Agent to New Window.

The agent leaves its original window and becomes the sole occupant of the new one. Its conversation, files, and state come along with it untouched - moving an agent never restarts it.

​

Moving Agents Between Windows

The Move to Window submenu (and the matching Quick Actions commands) lists every open window by number - Main Window, Window 2, Window 3, and so on (or a custom name if you have renamed one). Pick any window to move the agent there; the window it currently lives in is marked (current). Choosing Main Window brings an agent back to the primary window. A window can hold as many agents as you move into it. When you move the last agent out of a secondary window, that now-empty window closes automatically.

​

Telling Windows Apart

Maestro numbers windows so you can identify them in Cmd+Tab, Mission Control, and the Window menu:

• The main window keeps the plain title Maestro.
• Each secondary window shows a numbered title like Maestro [2], Maestro [3], and so on.

The number reflects the window’s position in Maestro’s window list and stays consistent with the badges shown in the Left Bar (below). If you close a window, the remaining windows renumber to stay contiguous.

​

Selecting an Agent That Lives in Another Window

The Left Bar always lists every agent across every window. When an agent is open in a window other than the one you’re looking at, its row shows a small blue window badge with that window’s number (tooltip: Open in window N). Selecting an agent that lives in another window focuses that window rather than yanking the agent over to your current one. This applies everywhere you can jump to an agent:

• Clicking the agent’s row in the Left Bar
• Cycling agents with Cmd+[ and Cmd+]
• The Quick Actions palette (Cmd+K)
• The Switch Agent picker (Cmd+O)

Each agent stays in exactly one window, so selecting it brings that window forward. To actually relocate an agent, use the Move to Window menu described above.

​

Window-Scoped vs. Global Shortcuts

Some shortcuts act only on the agents in the window you’re currently using, while others apply across the whole app. The window-scoped ones are: Because these are window-scoped, cycling or jumping between agents stays within the window you’re working in, and choosing an agent that lives elsewhere focuses its window instead of moving it. The shortcut help (Cmd+/) marks each of these rows with a Window badge so you can tell them apart from the app-global shortcuts. See the Keyboard Shortcuts reference for the full list.

​

Closing a Secondary Window

When you close a secondary window that still has agents in it, Maestro moves those agents back into the main window instead of closing them. A toast appears in the main window confirming the move:

Window closed - 2 agents moved to main window

No agent is ever left without a window. The reclaimed agents reappear in the main window’s tab strip exactly where you’d expect them.

​

Multiple Displays

Window positions are remembered per display. Drag a window to another monitor and Maestro records which display it lives on, then restores it there the next time you launch. If a display from your saved layout is no longer connected, Maestro falls back gracefully and re-centers that window on your primary display rather than spawning it off-screen.