Workspaces, tabs and panes

How Agentty organizes work — a workspace per project, tabs inside it, and panes inside those.

Agentty has three levels. A workspace is a project, a tab is one screen inside it, and a pane is one program: a shell, an AI agent, a file editor or a browser.

Workspaces#

Each row in the sidebar (⌘B) is a workspace, with a folder it opens in. ⌘N creates one.

  • Drag rows to reorder them, or drop one onto another to make a group. Groups collapse; right-click a group's header to rename it, colour it, Put all to sleep or delete it.
  • The search box above the list finds workspaces by name, folder or anything said in their conversations. While you search, the list turns into results: each one says where it matched — name, folder, or a line of the conversation with the words marked, and who said it. ✕ or Esc clears the search and brings the whole list back.
  • Workspaces linked into one session sit together under the one the link started from. When that one is in a collapsed group, the others stay listed in their own place.
  • Double-click a name to rename it.
  • ⌥⌘↓ / ⌥⌘↑ move between workspaces, ⌘1…⌘9 jump to one.
  • Every workspace, its tabs, splits and groups come back after a restart.
  • The ⚙ in the list's header opens Workspace Options: card layout (detailed or compact, whether detailed cards list running subagents — up to five, the rest as "+N"; ⌘-click one to open the subagents window — and whether they show their agents' state, time, tokens and cost), grouping (none, your groups, or by project — a repository and its worktrees together; a project folds like a group), order (manual, recent activity, name), filters (hide sleeping workspaces, workspaces on main / master, plugin workspaces) and whether the tabs sit in the title bar. The workspace you are in is always listed.
  • Awake workspaces first under the order in Workspace Options lifts the workspaces with something running above the sleeping ones within each group, each keeping its order; turned off, the list is as it was. The moon at the right end of the search box (in the header when the search box is off) shows the sleeping workspaces or hides them (a moon with a star while they are shown, the moon alone while hidden), the same as the filter.
  • With more than one window open (File → New Window, or another account's window), Move to Window › in a workspace's menu, or a window under Move group to window in a group's menu, moves it there. Its terminals keep running and its agents stay in their sessions, on the account they started with; its group comes along by name.
  • Workspace Options, the sidebar's width and the side panels' widths are set in the main window for every window. Changed in another window, they stay that way in that window only; Use the main window's at the bottom of its Workspace Options puts it back.

On macOS the tabs sit in the title bar next to the window buttons, with the sidebar button (⌘B) beside them; double-click the empty part of the bar to zoom the window. Turn Tabs in the title bar off in Workspace Options for a tab row of its own.

A workspace row shows the status of its agents, so you can see which project needs you without opening it. While an agent runs, a detailed card adds lines under the name:

  • its state, in the same words as the pane's header, how long it has run, and the tokens (and cost) its session has used
  • its to-do list's progress, such as To-do 4/9, with the item in hand; click it to open the whole list
  • each running subagent with what it is doing right now and for how long, and a count of the rest and the finished ones

The state line and the subagents can each be turned off in Workspace Options.

The workspace menu#

Right-click a workspace, or click its ⋯, for what can be done to it. Where an item works on a folder, it is the folder of the pane selected in that workspace.

ItemWhat it does
Open In ›Opens the folder in an editor or IDE found on this computer (VS Code, Cursor, Zed, the JetBrains IDEs, Xcode …) or in Finder
Copy PathCopies the folder's path
Copy Worktree Name / Copy Branch NameIn a worktree of its own, its name; otherwise the branch
PinKeeps the workspace at the top of its group
Mark as UnreadShows the attention mark on the card until you open it
New Group, Move to Group ›, Remove from GroupFiles the workspace in a group
Move to Window ›Moves the workspace, running, to another open window
Set Parent Worktree…Lists the workspace under another one you pick, indented; it moves between groups with it
Hide from remote accessKeeps the workspace off remote access: it isn't listed there and its terminals can't be reached. Choose it again to undo; a ✓ marks it while hidden. Shown while the remote access feature is on
SleepEnds every program in the workspace and keeps it as it was; its card is drawn faded with a moon, as is every workspace not opened since Agentty started. Opening it again starts its tabs and continues their agent sessions
Delete WorktreeCloses the workspace and removes its worktree and branch. Uncommitted changes and commits found nowhere else are kept
Delete WorkspaceMoves the workspace to the trash: its terminals close and it leaves the list, and it can be restored from there
View TrashOpens the trash

Tabs#

⌘T opens a terminal tab, ⌥⌘C Claude Code, ⌥⌘X Codex. The + menu has the same, plus the models and any other agent CLI found on your machine.

  • ⇧⌘] / ⇧⌘[ or ⌃Tab move between tabs, ⌃1…⌃9 jump to one.
  • ⇧⌘W closes a tab, ⌘W closes a pane.
  • Double-click empty space in the tab strip for a new tab.
  • Right-click a tab → Work on Later sets it aside: what runs in it stops, and the TODO button next to the start page tab lists it. Click it there to start it again; its agents continue their sessions.

New tabs start in the workspace's folder. Settings → General can ask for a folder each time instead.

Panes#

⌘D splits right, ⇧⌘D splits down. ⌘] / ⌘[ move between panes; drag the divider to resize.

Each agent pane has a status bar with the model, context window, rate-limit usage, branch, folder and the local server ports running in that pane. Its position (above or below the terminal) and which items it shows are in Settings → Appearance.

Double-click that bar — the status, or the icon it is dragged by — to give the pane the whole tab. Double-click again to put the split back the way it was.

The pane's header shows only the name of its folder; the status bar has the full path.

Side panels#

Panels dock beside the terminals and are resized by dragging their edge:

PanelShortcut
Files and working trees⌥⌘B
In-app browser⇧⌘B
Dockerstatus bar 🐳
Plugin panelstab strip button

Mini mode#

⌃⌘M folds the window into a small always-on-top panel at the edge of the screen. Agents that finish pop up as speech bubbles; clicking one brings the full window back.

On macOS the menu bar icon animates while agents work, lists them, and keeps Agentty running after you close the window.

The menu bar popover also shows the computer's CPU and RAM load beside the mini mode button, refreshed every 2 seconds while the popover is open. A value turns orange at 85% or more.