Creating a workspace in the wizard

A workspace is a self-contained environment for one project: its own working folder, its own pane layout, and its own set of agents. Close it and reopen - everything is in place. The wizard builds such a workspace in two steps.

Open the wizard

Launch pilotry and press Ctrl+N to open the new-workspace wizard.

Step 1 - folder and layout

• Name - how the workspace appears in the sidebar. Leave it empty and the folder name is used.
• Working folder - the path is shown on top; click “Browse…” or change the folder right from the cd line below (Tab/→ to complete, Enter to enter).
• Layout - choose how to split the window: from a single pane up to 2×4. Ten options in total.
• Presets (optional) - if a combo is already saved, clicking a preset creates the workspace right away, skipping step two. The ⋮ menu - edit, rename, delete.

Click Next.

Step 2 - an agent per pane

On top - an overview of the layout: the number on a pane matches the row number below. In each row pick the pane’s content: Shell or an agent (Claude Code, Codex, Gemini, opencode). Agent panes accept extra flags, e.g. --model opus; the terminal icon on the right switches the shell.

To avoid rebuilding the layout every time, save the “folder + layout + agents” combo as a preset (without the folder - a preset works in any). Next time a single click on step one is enough.

Done

Click Launch and the workspace opens with the chosen layout, each pane spawning its agent. A status ring appears around every pane: you can see who is ready, who awaits input, and who is still working.

Faster from the terminal

You can open a folder as a workspace without the wizard:

pilotry open ./api

Calling it again will not duplicate - it switches to the workspace that is already open.