Termy → Tutorial → Checkpoints & workflow

Checkpoints & workflow

What you need once the agent is writing more code than you are. These are Pro features, free for 14 days.

Checkpoints

Termy snapshots your project before every prompt you send, so any turn can be undone — including the ones you only regret ten minutes later.

• Press ⌘S for a snapshot right now (this works in the free version too).
• The clock icon in the panel's top bar opens the browser: every snapshot, what changed since, and a one-click restore.
• Restoring takes a safety snapshot first, so the undo itself is undoable.

Snapshots are git commits under refs/termy/…. They never touch your branches, your staged files or your history. Delete Termy and they're just unreferenced objects git cleans up on its own.

The workflow toolbar

The stacked-squares icon in the top bar shows a second row under the tabs:

• Turn diff. After each turn, the files it changed with +/− counts. Click to read the diff, or Revert turn to put everything back.
• Review notes. In any diff, click a line number to leave a note on that line. Send to Agent sends every note as one message, with file and line for each; if the agent is busy, it goes out when the turn ends.
• Snippets. Prompts you send often ("write tests for what you just changed"). Edit them in Settings → Snippets.
• Build errors. In an Xcode tab, reads the errors from your last build and hands them to the agent.
• Worktree. Starts a session on a new branch, made from the branch you pick, in a separate folder, so the agent's work stays out of your checkout. In a worktree tab the button becomes a branch menu: Changes vs main (everything the branch did, uncommitted work included), Create Pull Request (offers to commit, pushes, opens GitHub's PR page) and Merge into main (in your main checkout; a conflict calls it off and nothing changes). Closing the tab asks whether to keep the worktree or delete it with its branch, and tells you what would be lost.
• Queue next prompt. Line up the next instruction while the current turn runs; it goes out as the turn finishes.

The Agent Office

The little character next to the pin (or ⌘E) swaps the terminal for an office where your agents work. Each tab is a floor. Its agent sits at the corner desk; every subagent it starts walks in and takes a desk of its own. The first tab, Everyone, puts all your agents in one room, each project's agent next to its subagents, with the project's name on the agent's name tag.

• Monitors show the work: code for edits, a terminal for commands, a web page for fetches, a document for reads and searches.
• A raised hand means someone needs your OK. Click them for Allow / Deny.
• Finished helpers walk out and tick a box on the Done today whiteboard. An idle lead goes for coffee; when the plan limit is spent everyone naps until the reset.
• Click anyone for their task, time, tool calls, the last few things they did and their full transcript. The pencil next to a name renames them; leave it empty to get Termy's pick back.
• Chat with an agent: the panel that opens beside the room shows the conversation as it happens. Type in the box at the bottom and press Return (Shift-Return for a new line) to message that tab's agent; if it's busy, the message waits in the queue and sends when the turn ends. Subagents and Elsewhere agents can be read but not messaged.
• Click the "Done today" whiteboard (or the chip at the top) to read what got done: every finished subagent task and every finished turn, with what the agent reported, the time it took and a link to the transcript.
• The log at the bottom tells the story: who joined, who finished and in how long, who needs you.
• Claude sessions running outside Termy work on the Elsewhere floor. Codex tabs show their lead.

While subagents run, the notch shows their tiny heads next to the activity line, and the mascot's badge counts them.

Termy Browser

When a session starts a local server, its address appears in the links bar above the terminal. Click it to open it in Termy Browser, a window that belongs to that tab:

• Pick, then click any element: its HTML, computed styles and a screenshot are saved and their paths typed into the prompt, ready for "make this look like…".
• Screenshot adds a picture of the whole page to the prompt.
• Console errors the page logs are collected; one click hands them to the agent.

When the plan limit hits

Queue up three prompts for the evening and it's a real possibility: your 5-hour window runs out halfway through. Termy watches your plan usage, and when the quota is spent it holds the queue instead of feeding prompts into a wall. You get a notification — "Claude plan limit reached. 3 queued prompts will be sent at 9:15 PM" — the queue badge turns orange with a clock, and when the window resets the prompts go out on their own.

The menu bar menu shows your current usage for both Claude and Codex, with reset times. Turn the holding off in Settings → Agent.

Usage insights

Usage Insights… in the menu reads every Claude Code transcript on your Mac and shows tokens and estimated cost per project and per day, over 7, 30 or 90 days. Costs are estimates at public API rates: useful for comparing projects, not for reconciling a bill.