ratchet Get ratchet

For people running Claude Code on more than one thing at once

All your Claude Code agents, one tab.

ratchet is a local dashboard for your git repos. See what every agent is doing, start a new task in its own worktree, review the diff, open the pull request and watch CI, all without leaving the browser. When an agent needs you, your phone buzzes.

npm install -g @ratchet-ai/ratchet
Install guide
Windows 10/11 and macOSRuns on your PCUses your own Claude Code and GitHub logins
127.0.0.1:4700
storefront 1
payments-api 2
docs-site
infra
+
Agents 1 waiting Terminals Files
Git
Changes 7 Commits Branches Worktrees 4
GitHub
Pull requests 3 CI runs 1 failed
Machine Plugins Settings
Agents · 4
● connectedCPU 23%RAM 11.8 / 32 GB4 Claude sessionsphone: on

Example data. Click an agent in the desktop view to see its transcript.

What's inside

The things you tab between all day, in one place.

One tab per repo, a short menu on the left, one view at a time. No rules, nothing blocked. ratchet shows you what's happening and gets out of the way.

Agents

Every session, with its live transcript

Each Claude Code agent running against an open repo gets a card: what it's working on, which branch, its pull request and CI. Waiting on you shows in amber, so you answer the one agent that's stuck instead of checking five terminals.

● waitingMigrate orders to UUID keysdb/uuid-orders · 4m
● workingRetry failed Stripe webhooksfix/webhook-retry · 18m
● ci failedDark mode for account settingsPR #214 · lint
New task

A worktree per task, in one click

Name the task. ratchet makes a fresh worktree and branch and opens Claude Code in it, ready for your first message, so parallel agents never step on each other's files.

Git

Changes, commits, branches

Read the diff an agent left behind, commit it, see ahead/behind counts and switch branches without a terminal.

GitHub

Pull requests and CI runs

Open PRs and recent Actions runs for the repo, next to the agent that made them. A red check shows on the agent's card.

Files

Browse and search the repo

Find a file, read it with syntax highlighting, open it in VS Code.

Machine

Know when the PC is struggling

CPU, memory, disk and every running Claude process. Close the sessions you don't need. Leftovers from ratchet's own agents are cleaned up for you. Windows for now.

CPU ▁▂▂▃▅▃▂▂ 23%
RAM ▅▅▆▆▇▆▆▆ 11.8 GB
4 Claude sessions · 0 leftover
Updates

One-click update

When a new version is out, a banner shows what's new and updates ratchet for you.

Start-up check

Tells you what's missing

Checks Node, git, GitHub CLI and Claude Code when it starts, and says exactly how to fix anything that isn't there.

Terminals

A plain shell per project

Open a terminal in the repo's folder for git, tests or anything else you'd type, on your PC or your phone.

Own window

Opens like an app

Install ratchet from Edge or Chrome and it gets its own icon and window. The window keeps working after ratchet restarts or updates.

Background

Keeps running, starts with your PC

Close the terminal and ratchet and your agents keep going. Turn on Start ratchet when I sign in and it's ready before you are, so your phone can reach it straight away.

On your phone

Walk away from the desk. The agents keep going.

Turn on phone access and open the same workspace from your phone. Add it to your home screen and it works like an app.

Alerts for what mattersA push alert when an agent asks a question, wants permission, finishes, or its pull request fails CI. Pick which ones and set quiet hours in Settings.

Answer and move onTap the alert to land on that agent, read what it asks, answer it, and it carries on.

Off until you switch it onPhone access stays off by default. When on, it reaches your PC through the ratchet relay or your own Tailscale. Pair with a QR code.

Several PCs, one phoneOver the relay, one phone keeps up to 10 PCs. See which are online and switch between them, and an alert opens the PC that sent it.

Plugins

Bring your own flows.

Plugins change how agents start and react to what they do. Add the ones you want, write your own with Claude, and share them with a git link.

Your flow, not a built-in oneSend Claude through the Headroom proxy, keep the PC awake while agents work, or have a plugin run checks and ask you to approve or reject before a merge.

From a folder, a git link or a packA pack is one file that lists several plugins, so a team can hand out the same set.

See what it can do, then allow itThe Allow dialog lists every permission in ratchet's own words. Nothing runs until you tap Allow, and plugins with code say so.

Off where you don't need itSwitch a plugin off for one project, change its settings, and see its activity. After 3 failures in a row it turns itself off, and your agents keep going.

Updates that only tell youOnce a day ratchet checks each plugin's git link and says when an update is out. Nothing changes until you press Update, and an update that asks for more waits for your Allow.

Using pluginsWriting plugins
127.0.0.1:4700
The Plugins page in ratchet: plugins grouped by Needs you, On and Off, with the Headroom plugin open showing its running helper, what it can do, its settings and the projects it is off in.
Why not just Claude Code

Claude Code's own remote is good. Here's what it leaves out.

Remote Control, the desktop app and agent view already cover a lot: several sessions, worktrees, phone alerts. ratchet fills the gaps that are left, and works alongside them.

ratchet compared with Claude Code's own tools
FeatureratchetRemote Control + Claude appClaude desktop appAgent view (claude agents)
Shows agents you started in a normal terminalYesPlain claude, no flagOnly if started for itNeeds the remote-control flag or auto-connectOnly to resume/resume lists CLI sessions, but not while they run in a terminal.After you background themOpen sessions in other terminals stay hidden
Git changes, commits, branches, PRs and CI for code on your PC, from your phoneYesPartlyPhone shows a diff of your changes, no commits, branches, PRs or CI for local code.NoDesktop onlyNoNo phone access
Works with API keys, Bedrock, Vertex or a company gatewayYesratchet uses whatever Claude Code usesNoNeeds a claude.ai planPartlyRemote access needs a claude.ai planYes
Team and Enterprise plans, no admin switchYesOff by defaultAn admin has to turn it onYesYes
Where phone traffic goesYour choiceThe ratchet relay, or your own TailscaleThrough Anthropic's serversThrough Anthropic's serversNo phone access
Most multi-agent tools only see their own agentsClaude Squad and Vibe Kanban show the agents they started. Happy needs you to run happy claude instead of claude. ratchet picks up the sessions you already have.
Windows and Mac, both first-classConductor and Sculptor don't run on Windows. Every ratchet release is tested on a Windows PC and a Mac before it ships.
No accountNo ratchet login. ratchet runs on your PC and uses your own GitHub and Claude Code logins.

Based on each product's public docs, checked October 2026.

Install

Running in under a minute.

  1. Install the package

    One global npm install. Needs Node 22.12 or later.

  2. Start it

    Type ratchet. It checks your setup, opens in your browser and keeps running after you close the terminal.

  3. Add a repo

    Pick a folder, or let ratchet find repos from your recent Claude Code sessions.

  4. Start a task

    Press New task, name the worktree, then tell Claude what to do in its terminal.

You'll need

  • Windows 10 or 11, or macOS
  • Node.js 22.12 or later
  • git, and GitHub CLI signed in (gh auth login)
  • Claude Code. On Windows, the native install (claude install)
PowerShell

Windows

PS> npm install -g @ratchet-ai/ratchet
added 3 packages in 6s

PS> ratchet
ratchet 0.7.0
  ✓ Node 22.20
  ✓ git 2.47.0
  ✓ GitHub CLI 2.60.0
  ✓ Claude Code 2.1.0
Logs: C:\Users\you\.ratchet\logs
ratchet is running at http://127.0.0.1:4700/?t=…

Scripts disabled? run ratchet.cmd instead, or once:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

macOS

~ % npm install -g @ratchet-ai/ratchet
added 3 packages in 5s

~ % ratchet
ratchet 0.7.0
  ✓ Node 22.20
  ✓ git 2.39.5
  ✓ GitHub CLI 2.60.0
  ✓ Claude Code 2.1.0
Logs: ~/.ratchet/logs
ratchet is running at http://127.0.0.1:4700/?t=…

Tip: install Node with nvm or Homebrew so
npm install -g needs no sudo.

To update later: press Update now on the banner, or run npm install -g @ratchet-ai/ratchet@latest.

Your own sessions are only read.ratchet reads Claude Code's transcripts and never changes sessions you start yourself. Agents ratchet starts get local hooks so it can see permission prompts; Away mode and plugins change them only when you turn those on.
Free to useFSL-1.1-MIT licence. Use it at work or at home. Each release becomes MIT two years after it ships.
Questions

Good to know.

Does it cost anything?

No. ratchet is free. You pay for Claude Code as you do today.

Does it work with agents I started in my own terminal?

Yes. Any Claude Code session running against a repo you've added shows up on the Agents view with its transcript.

Does it replace Claude Code?

No. Claude Code does the work. ratchet is the place you watch, start and review that work across repos.

How does phone access reach my PC?

Through the ratchet relay or your own Tailscale, whichever you choose. The relay passes on encrypted traffic it can't read; Tailscale keeps traffic on your own private network. It's off until you turn it on with the Phone access button at the bottom right of ratchet, and you pair each phone by scanning a QR code.

Can I merge pull requests in ratchet?

Not yet. You open and review PRs in ratchet, then merge on GitHub.

Where does it keep its data?

In the ~/.ratchet folder: the repos you added, the agents ratchet started, your settings and paired phones. Delete the folder to reset ratchet.

Linux?

Not yet. Windows 10/11 and macOS today.

What if something is missing on my PC?

ratchet checks when it starts. If Node or git is missing it tells you the fix and stops. If GitHub CLI or Claude Code is missing it starts anyway and shows a notice saying what to install.

Stop checking five terminals.

Install ratchet, add a repo, start a task.

npm install -g @ratchet-ai/ratchet

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