orchestra / docs
Documentation/Configuration

Usage

See subscription limits for your agents and OpenRouter spend by model.

On this page Subscription usageOpenRouter account usage

Subscription usage

Open Settings → Usage to see the account limits shared across your sessions. For Claude Code and Codex, Orchestra asks the signed-in CLI for each limit window, how much is left, and when it resets. No prompts are sent.

Usage refreshes while the page is open; click Refresh to check again. Other agents do not report usage yet.

OpenRouter account usage

Paste an OpenRouter management key and click Connect. Orchestra shows your available balance, total spent, and total credits purchased.

Usage by model covers the last 30 complete UTC days, with spend, requests, and input, output, and reasoning tokens for each model. Bring-your-own-key costs are listed separately.

The key is stored in the macOS Keychain. Use Change key or Remove key to replace or forget it. OpenRouter usage is available on macOS only, because Linux builds cannot store the key.

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