ratchet docs
Docs / Use ratchet / Worktrees

Worktrees

Parallel copies of the repo, one per task. ratchet shows what's in each one and whether it's safe to remove.

127.0.0.1:4700
Worktrees: the agent in each folder, its progress, PR and disk size.
Worktrees: the agent in each folder, its progress, PR and disk size.

Status chips

Each worktree shows one of: agent working, agent waiting, uncommitted, merged · safe to remove, folder missing, or clean.

Details

  • Created: when, and how: by ratchet's New task, by Continue with Claude, or by hand.
  • Progress: commits ahead of the base branch, and uncommitted changes.
  • Pull request: its number and check results.
  • Disk size: measured every few minutes, with the biggest folder named (usually node_modules).
  • Agent: jump to the agent working there.

Remove a worktree

Press Remove. The branch stays. The folder is deleted, including files git ignores, like .env. ratchet refuses while the worktree has uncommitted changes or an agent is working in it. The main folder can't be removed.

Screenshots use example data. Written for ratchet 0.2.1.

ratchet is an independent project by Shervin Davarifard. Questions or problems: hello@ratchet.build.© 2026 Shervin Davarifard · FSL-1.1-MIT licence