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 (set PLOTTYPUS_BIN_DIR to change it), then opens your browser to connect this machine.
  • Over SSH, plottypus login --no-browser prints the link instead.
  • It needs Claude Code installed. Claude Code needs nothing extra: plottypus adds its hooks to ~/.claude/settings.json and 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.

CommandWhat it does
plottypus statusShows whether this machine is connected and reviewing.
plottypus pausePauses review on this machine only. The hooks stay but send nothing.
plottypus resumeTurns review back on for this machine.
plottypus exclude <folder>Keeps a folder out of review.
plottypus include <folder>Brings an excluded folder back.
plottypus checkReviews the session in this repository now.
plottypus reviewShows the latest review for this repository (.plottypus/review.md).
plottypus doctorChecks the install.
plottypus updateInstalls the latest signed version. It also updates itself.
plottypus logoutDisconnects this machine.

sharing. your call.

Help improve plottypus is on unless you turn it off: at connect, in Settings → Privacy, per project, or with plottypus share off. What it keeps and for how long.

uninstall. one command.

plottypus uninstall
  • plottypus uninstall removes the hooks, stops the background service, disconnects this machine and deletes ~/.plottypus.
  • plottypus uninstall --all also deletes the program.
  • Add -y to skip the question.