ratchet docs
Docs / Use ratchet / Agents

Agents

Every Claude Code session running in the repo or one of its worktrees, with what it's doing right now.

127.0.0.1:4700
Agents: the list on the left, the selected agent's conversation on the right. This one is waiting on your answer.
Agents: the list on the left, the selected agent's conversation on the right. This one is waiting on your answer.

Which agents show up

ratchet reads Claude Code's session files, so it finds agents wherever you started them: in ratchet, in VS Code or in a terminal. Finished agents stay in the list for the day they were last active. One-off claude -p runs aren't listed.

What each status means

StatusMeaning
WorkingClaude is in the middle of a turn, or background work it started is still running.
Waiting on youClaude asked you a question or wants a plan approved.
Wants permissionClaude is waiting for you to allow a command or an edit. Only for agents ratchet started.
DoneThe turn finished and nothing is running, or the session has closed.
Agents started outside ratchet

ratchet can read them but not type into them. They show Started outside ratchet — answer it where it runs. A permission prompt in one of them shows as Working, because ratchet can't see it.

What a card shows

Each row has the agent's name, status, last step, how long it has run and an estimated cost. A no prompts chip means the agent runs without asking for permission.

The Claude terminal

Agents ratchet started open in a real Claude Code terminal inside the page. Switch between Terminal and Transcript, or press Big terminal for more room (Esc goes back). Ctrl+C copies when text is selected, and Ctrl+V pastes text or images.

When a session has ended you see Session ended — type to continue. Type, or press Continue, and ratchet resumes the same conversation.

127.0.0.1:4700
On the phone the agent opens full screen. Here it is asking you a question.
On the phone the agent opens full screen. Here it is asking you a question.

Context and jobs

127.0.0.1:4700
A working agent with its background test run open under Jobs.
A working agent with its background test run open under Jobs.
  • Context shows how the agent's context window is used: system and built-in tools, plugins and skills, MCP tools, CLAUDE.md and memory, the conversation, and what's free. It also flags plugins and MCP servers that are loaded but never used.
  • Jobs lists background commands and subagents, with their output and whether they're running, done, failed or stopped.

Continue with Claude

From Branches and Worktrees, Continue with Claude writes a starting prompt for that branch. From an open pull request, Review with Claude does the same for a review. Edit the prompt, then Copy & open Claude starts a new agent in the right folder.

Screenshots use example data. Written for ratchet 0.2.1.

ratchet is an independent project by Shervin Davarifard. Questions or problems: [email protected].© 2026 Shervin Davarifard · FSL-1.1-MIT licence