DocsGet started
Run an agent
Start your coding agent in Whaatcher's terminal so its sessions, turns and tokens are recorded. Whaatcher records only agents that run in its own terminal.
Before you start
Claude Code must already be installed, and claude must start from your shell. Add the repository first; see Add repositories.
Start your agent
- On the Dashboard, click Files or Graph on the repository's card to open its tab.
- Press ⌃` (Toggle Terminal).
- Type
claudeand press Return.
The terminal opens as a card over the tab, in the tab's worktree, with your usual login shell. Press ⌃` again to hide it; the agent keeps running. Click the agent tile on the tab to bring it back.
Main terminal and child terminals
The first terminal you open in a tab is its main terminal, the seat for your agent. For a dev server or a quick check, open a child terminal with Open Terminal (⌃⇧`). Only the main terminal is observed, so an agent started in a child terminal runs but isn't recorded.
Observed sessions only
Agents you start in another terminal app aren't recorded either. Screens built from the record say so with Observed sessions only. Whaatcher only reads the files Claude Code keeps in ~/.claude; it doesn't change them or your settings. Other agents, such as Codex, are recognized by name, but their activity is marked Not supported and left out of the counts; see Supported agents and hosts.
When you quit Whaatcher
Quitting Whaatcher doesn't stop your agent, and neither does a crash. When you open Whaatcher again, each session reattaches in its tab with its screen and scrollback. If the agent is still running then, the turns it made while Whaatcher was closed are added to the record. Restarting your Mac or logging out ends every session. To end a session yourself, close its terminal; Whaatcher asks first if something is still running.
Where the record shows up
While your agent works, Whaatcher records each session's turns, tool calls and tokens, and the memory its processes use. Hindsight shows every agent session on one timeline, with memory, tokens, tool calls and errors. Worklog, a tab of the commit panel, shows the agent's work behind one commit by turn and by file. Insight adds up agent time and tokens over a day, week or month. Agent sessions and turns explains what a session and a turn are.