orchestra / docs
Documentation/Workspace

Saved workspace & resume

Return to your projects and continue a captured agent conversation.

On this page What is savedResume an ended sessionWhen no conversation ID is availableWhat does not survive a restart

What is saved

Orchestra saves project folders and names, sidebar order, session names, agent choices, worktree locations, captured conversation IDs, and selection state. Each project remembers its last selected session.

On launch, Orchestra opens the Startup View from Settings without starting agent processes. Selecting a restored session starts or resumes its CLI in its folder.

Resume an ended session

Right-click an ended session and choose Resume Session, or use the resume button above its terminal. The action reopens the saved conversation using the agent ID. It does not send the original task again.

Claude Code, Pi and Grok Build sessions use the Orchestra session UUID as their own session ID, then resume with that ID. Other CLIs capture their own conversation IDs. The conversation history is owned by the agent CLI and must still be available on your computer.

When no conversation ID is available

Some agents only create a resumable conversation after work has begun. Vibe, for example, requires a saved conversation in its session logs.

If Orchestra has no ID for a previously launched session, it requires an explicit Start New Conversation action. It does not guess by selecting an unrelated recent conversation.

What does not survive a restart

Live processes and terminal scrollback are not persisted. Resume restores the agent conversation through its CLI; it does not restore a still-running shell process. Plain terminals start a fresh shell.

Workspace metadata is local. See Settings & storage for file locations and messaging history behavior.

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