Sessions
An Agent Studio session is one Claude Code process and conversation in one absolute working directory. You can keep several live sessions for an agent or folder and switch among them as tabs.
Live sessions
Section titled “Live sessions”New session starts a fresh Claude Code process. Studio names it from a title Claude derives from the conversation, falling back to the folder name; a name you set yourself takes precedence. Closing a live tab asks for confirmation and then ends that terminal process. Exited sessions move into history.
These states answer different questions:
| State | Question answered |
|---|---|
| Running | Is the terminal process alive? |
| Ready | Can Studio safely send programmatic input to Claude? |
| Focused | Which agent or folder is the UI showing? |
| Active | Which tab receives keyboard and image input? |
| Bound | Which agent project do Canvas and direct actions target? |
A session can be running but not ready while Claude shows a trust, authentication, or first-run prompt. Use the visible terminal to finish that prompt. Focusing another agent changes the UI subject; focusing does not rebind the session.
Review history before continuing
Section titled “Review history before continuing”Open History in the rail to search sessions Studio has recorded and conversations still available from Claude Code. Studio checks recent working directories, merges the two sources, removes duplicate entries, and shows the newest results first.
Selecting a history row opens its recorded events for review. Reviewing a row does not launch a process. Choose a continuation action only after confirming the directory and the context you need.
Resume, Continue here, or start fresh
Section titled “Resume, Continue here, or start fresh”| Choice | What happens | Fidelity |
|---|---|---|
| Resume | Studio verifies the Claude conversation still exists, then starts claude --resume in the recorded directory. | Claude owns and restores its native conversation. Studio reuses the tracked session and binding when available. |
| Continue here | Studio starts a new Claude conversation in the same directory and injects a bounded brief assembled from Studio events. When the source is a Studio-tracked session in that directory, the new session also preserves its recorded agent-project binding. | This is a briefing, not restored model context, a terminal replay, or Claude’s native conversation record. The new session must inspect the repository. |
| New session | Studio starts a normal fresh conversation in the chosen directory. | Nothing from the earlier conversation is carried automatically. |
Native Resume is offered only after Studio checks Claude’s history. If that verification fails, use Continue here. A history item without a matching Studio record can still open as an ordinary fresh session, but no Studio brief is available.
The portable brief favors recent context: roughly the newest 12 turns, shortened prompt and reply text, recent tool activity, up to 30 referenced paths, and up to 10 recent commands. It says when material was omitted. A transcript-only row has no prior Studio binding to preserve, and a missing brief starts nothing under the guise of a continuation. Even when a tracked binding carries forward, confirm the active tab and bound agent before using a direct action.
Quick Jump and tab shortcuts
Section titled “Quick Jump and tab shortcuts”Open Quick Jump with ⌘+K or ⌘+P on macOS, or Ctrl+K or Ctrl+P elsewhere. It searches live sessions, past sessions, agent projects, and recent folders, and it can open the template browser. Use ↑/↓, Enter, and Escape to navigate.
Choosing an agent or folder from Quick Jump can start a fresh session when no suitable live tab exists, so it is more than a navigation-only menu.
Use ⌘+1 through ⌘+9 on macOS, or Ctrl+1 through Ctrl+9 elsewhere, to select the corresponding live tab for the currently focused agent. Tabs are numbered oldest first.
© 2026 Sapiom, Inc.