set it up in one paste.
Sign in, paste one line into your terminal, and keep using Claude Code as you do now.
install. one line.
curl -fsSL https://plottypus.com/install | sh- Works with Claude Code on macOS, Linux and Windows (WSL). On native Windows, use WSL.
- Works in any folder, git or not. Claude Code sessions you already have open are picked up, with no restart.
- It puts the program in
~/.local/bin/plottypus(setPLOTTYPUS_BIN_DIRto change it), then opens your browser to connect this machine. - Over SSH,
plottypus login --no-browserprints the link instead. - It needs Claude Code installed. Claude Code needs nothing extra: plottypus adds its hooks to
~/.claude/settings.jsonand keeps your own hooks.
what it does. what it reads.
- It follows your Claude Code session: what you ask, each edit, each command and its output, and when it says done.
- The reviewer checks every done against what actually ran, and messages the agent when it does not hold.
- Before anything leaves your machine, the CLI removes API keys, tokens, passwords and private keys, and it never reads .env files, key files, SSH or cloud credential folders, or anything your .gitignore ignores.
everyday commands.
| Command | What it does |
|---|---|
plottypus status | Shows whether this machine is connected and reviewing. |
plottypus pause | Pauses review on this machine only. The hooks stay but send nothing. |
plottypus resume | Turns review back on for this machine. |
plottypus exclude <folder> | Keeps a folder out of review. |
plottypus include <folder> | Brings an excluded folder back. |
plottypus check | Reviews the session in this repository now. |
plottypus review | Shows the latest review for this repository (.plottypus/review.md). |
plottypus doctor | Checks the install. |
plottypus update | Installs the latest signed version. It also updates itself. |
plottypus logout | Disconnects this machine. |
uninstall. one command.
plottypus uninstallplottypus uninstallremoves the hooks, stops the background service, disconnects this machine and deletes~/.plottypus.plottypus uninstall --allalso deletes the program.- Add
-yto skip the question.