orchestra / docs
Documentation/Workspace

Sidebar & navigation

Arrange the sidebar, switch projects with Arc Mode, and keep track of activity.

On this page The sidebarDrag to reorderArc ModeMove between itemsStatus bar

Drag to reorder

Drag a project by its title to reorder projects. Within a project, drag sessions, terminals, and the Scratchpad into any order. Issues & PRs always stays first. Press Esc to cancel a drag.

From the keyboard, use Move Up and Move Down in the context menu.

Arc Mode

Turn on Settings → Appearance → Arc Mode to show one project at a time. Project spaces appear at the bottom of the sidebar, beside Settings and a + button for new projects.

Click a space to switch projects, or scroll horizontally over the sidebar. When the spaces have focus, the arrow keys move between them. Right-click a space for its project menu.

Move between items

Press ⇧⌘[ and ⇧⌘] for the previous and next item in the sidebar, crossing into the neighboring project.

Press ⌘K and choose Go to… to jump to any project, Issues & PRs, scratchpad, or session. See the command bar for every command.

Status bar

The status bar at the bottom of the window shows:

  • The project and its GitHub repository.
  • For a session, its activity and either its worktree branch or Project folder.
  • How many sessions are working, waiting, or running across all projects.
  • A Changes button for the selected session’s Changes pane.
  • An Update button when a new version is available, and Restart to Update once it is ready.
  • An Inbox button when messages need attention.
  • The current theme. Click it to switch between Light and Dark.

Browse documentation

Welcome to OrchestraA macOS workspace for your projects, terminals, and coding agents.
InstallationDownload Orchestra from GitHub Releases, or build it from source.
Projects & sessionsOrganize your work around folders, with an isolated worktree and terminal for every session.
Supported agentsUse the agent CLIs you already know, with their own configuration and credentials.
TerminalA real interactive terminal, running your agent or shell in its own folder.
Sidebar & navigationArrange the sidebar, switch projects with Arc Mode, and keep track of activity.
Saved workspace & resumeReturn to your projects and continue a captured agent conversation.
Issues & pull requestsRead and triage repository context, then start an agent session without leaving Orchestra.
Session messagingExchange requests and replies between existing sessions in the same project.
AppearanceChoose a palette for the whole workspace, including your terminals.
Custom themesCreate your own palette in a JSON file and use it beside the built-in themes.
UsageSee subscription limits for your agents and OpenRouter spend by model.
Settings & storageGeneral preferences and where Orchestra keeps workspace metadata and message history.
Privacy & usage dataOptional anonymous usage sharing, approximate city and country, and every collected event.
Keyboard shortcutsThe everyday actions you can reach from the keyboard.
ContributingReport issues, propose changes, and build Orchestra locally.
FAQAnswers to the questions that come up before your first session.
↑↓ Navigate↵ Openesc Close