orchestra / docs
Documentation/Workspace

Terminal

A real interactive terminal, running your agent or shell in its own folder.

On this page Your shell and environmentTerminal appearanceProcess lifetimeIf a CLI cannot be found

Your shell and environment

Every session hosts an interactive xterm.js terminal with 256-color and true-color support. Orchestra starts it through your login shell, so your profile, rc files, and PATH load before the selected CLI.

Your usual shell setup and installed tools are available to the agent. Use plain terminals when you just need a shell in the project folder.

Terminal appearance

The terminal follows the selected app theme and Light or Dark mode, including its background, text, and ANSI colors.

Open Settings → Terminal to set the font size from 10 to 24 pt, the horizontal and vertical padding from 0 to 24 px, and turn font smoothing on or off. These preferences are saved between launches.

Process lifetime

Switching sessions keeps processes running. Closing a session stops its process and removes it from the project. Closing the app window quits Orchestra; while sessions are running, it asks first unless you turn off Confirm Before Quitting.

Terminal scrollback is kept while the process is in the open app. It is not part of the saved workspace snapshot. Resuming a session restores the agent’s conversation through its CLI.

If a CLI cannot be found

Check that the agent command is installed and available in your login shell. Open a new session after correcting your shell setup. Keep authentication in the agent’s own CLI.

For the command names, see Supported agents.

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