Sessions

What a session row shows#

• Agent (Claude Code, Codex, Cursor, Qoder, CodeBuddy, Gajae Code, Grok Build, Kimi Code, Hermes, OpenCode, MiMo Code, GitHub Copilot, Kilo Code, Factory Droid, Antigravity, Qwen Code, Pi, Oh My Pi, Goose, Kiro, Cline, Mistral Vibe, ZCode, Aider, and Devin), shown by its avatar and project name.
• State, shown by the avatar's color and motion: executing, thinking, waiting, idle, or an attention state when a session stalls.
• What it's doing right now, with a per-tool icon so a read, an edit, and a command each read differently at a glance.
• Quick metrics when the agent's session source reports them: tokens, files, commands, diff plus and minus lines, elapsed time, cost, model, account, git branch, and active subagents. AgentPeek leaves unsupported fields absent; a Claude session nearing its context limit shows a warning chip.
• The agent's working checklist as it updates, including Claude todos and Codex plans, plus a collapsible view of any adopted plan.

Expanding a session#

Click a row to expand it: the latest reply, rendered as Markdown in a collapsible Last reply section, and a timeline of everything that happened: tools run, prompts, permissions, questions, and compactions. A focused session can grow to full height, with Transcript, Subagents, Todos, and Tools sections you collapse independently; each section takes a row limit or Unlimited, and reopens exactly as you left it.

Subagents get their own timelines inside the session that started them, and they count toward Markdown exports too.

Session actions#

Right-click a session for more, including jump back to the terminal, copy the session as Markdown, reveal paths in Finder, and end the session when AgentPeek can safely target it. Dismiss a quiet row with the trash button; ended sessions retire from the list on their own.

Jump-back precision depends on the host application; the host matrix documents exactly what each terminal and editor supports.

Parallel sessions#

Run as many parallel sessions as your Mac can handle; there is no session cap in AgentPeek itself. When several agents run at once, prompts stack in the notch and arrow keys move between them, the Agent Board sorts sessions into status columns, and Views launch a whole multi-pane workspace in one click.