The session view
Anatomy of a running session: transcript, tools, file edits, terminal, and the composer.
- Topic
- Sessions
- Available on
- Available onDesktopWeb PortalMobile
- Reviewed
- September 28, 2026
On this page
Once a session is running, the center pane is where you watch the agent work. The layout is the same across desktop and portal; mobile adapts to a single-column view.
The three panes
The session view has three main regions:
Sessions sidebar — on the left. Lists every session on the current host, sorted by recent activity by default (other sort options include project, agent, status, name, and changes). Each item shows the session title, the agent it’s running, current status, and live counts for unsaved changes if you’re editing files.
Transcript — the center. The full conversation, interleaved with tool calls, file edits, and command output. Long blocks (file diffs, command output) are collapsible. New events stream in at the bottom; the view auto-scrolls unless you’ve scrolled up.
Composer — the bottom strip. The text area where you send a follow-up. Drop files in to attach them, or use the / menu to switch the agent or insert a slash-command the agent supports.
Status dots
Each session has a colored dot:
- Teal pulsing — running, the agent is actively producing output.
- Teal solid — ready or completed.
- Amber — waiting for your input, or interrupted.
- Violet — paused.
- Gray — stopped.
- Red — failed. The last error message is shown when you hover.
What you’ll see in the transcript
Every event from the agent shows up as a distinct block:
- Messages — the agent’s reasoning and replies. Markdown is rendered.
- Tool calls — when the agent invokes a tool (read file, run command, search, etc.). The arguments and result are both visible. Risky tools trigger an approval card; see Permissions and approvals.
- File edits — shown as a unified diff. Click to open the file in the built-in editor and apply, modify, or revert.
- Command output — standard output and error from shell commands the agent ran.
- Questions — if the agent needs information from you, a question card pins to the top of the transcript with the choices. Answers send through encrypted; the relay never sees the text.
Sending follow-ups
Type in the composer and press Enter to send. Shift+Enter inserts a newline. The agent picks up the new message on its next turn.
Keyboard
The composer and transcript have their own shortcuts. The macOS keys are listed; on Windows and Linux use Ctrl for Cmd and Alt for Option.
| Shortcut | Action |
|---|---|
Cmd+L | Focus the chat input from anywhere in the workspace |
Shift+Tab (in the chat input) | Cycle the permission mode, for example Ask, Accept edits, Plan. Bypass is never reached this way |
Cmd+Option+M | Choose the agent and model |
Cmd+Shift+Backspace | Interrupt the running turn |
Cmd+F | Find in the chat. Enter or Cmd+G goes to the next match and Shift+Enter or Cmd+Shift+G to the previous one. Esc closes |
Cmd+Option+L | Jump to the next session that is waiting or ready |
Find in the chat searches the messages you and the agent wrote in the loaded conversation. It skips tool output and turns that are condensed into a summary. See Keyboard shortcuts for everything else, including the web portal’s keys.
You can also drop a file or paste an image into the composer. Both are attached to the message and (for images) sent through the relay encrypted.
The session header
Above the transcript, the header offers:
- Interrupt — cancel the current turn so you can redirect the agent without killing the subprocess.
- Stop — end the session cleanly.
- An overflow menu for renaming and other session controls.
Side panels for git, files, and terminal can be opened from the right rail of the session view rather than from the header.
On mobile
Mobile shows the chat / transcript by default, and gives you tabs to switch to git, files, or terminal side panels for the same session. The phone layout shows one panel at a time; tablets in landscape can show two.
Compose a follow-up by tapping the message bar at the bottom. Voice input is supported; see Mobile > Voice input.
When the session has subagents, or coordinates or works on an open orchestration run, a bar just above the message bar sums up that work. Tap it to open a sheet; when the session has both a plan and subagents, the sheet has Plan and Subagents tabs. A Glueprint session subagent you tap there opens inside the same sheet, with its messages, its questions and permission requests, and a message bar; Back returns to the list, and Open full session opens its own page. Harness rows (Claude Task/Agent, Codex collab) open an activity page with Back and Close. See Where orchestration shows up.
On the portal
The portal layout matches desktop. Some heavier features (full editor, file browser, multi-pane git) are linked from the session toolbar and open as right-side sheets so the transcript stays visible.