Docs · Pawpilot

Install

Pawpilot ships as a native build for each platform. Grab the one for your machine, then open it.

macOS

Universal binary — runs natively on Apple Silicon and Intel. Open the DMG and drag Pawpilot to Applications.

Download for macOS

Windows

x64 NSIS installer. Run the setup file — the cat appears in your tray and on the desktop once complete.

Download for Windows

Unsigned builds — a one-time prompt

Pawpilot isn't code-signed yet, so your OS will warn you the first time you open it:

macOS: right-click the app → Open → Open again. Or, after a blocked launch, go to System Settings → Privacy & Security and click Open Anyway.
Windows: on the SmartScreen dialog, click More info → Run anyway.

Activate your key

After purchase, your license key is emailed to you instantly (you can also re-fetch it any time from your account). It looks like this:

License key

PAW1.eyJwcm9kdWN0IjoicGF3cGlsb3Qi....AbCdEf

Open Pawpilot and click the cat (or its tray icon) → Activate.
Paste your full key, starting with PAW1.
Click Activate. The key is verified offline against an embedded public key — no internet required.

One key works on every device you own. Paste the same key on your other machines — there's no per-seat limit.

Permissions

Some of Pawpilot's best motions — Keyboard Kneading, the typing rhythm reactions — need to know when you're typing (never what you type). On macOS that means granting Input Monitoring.

Open System Settings → Privacy & Security → Input Monitoring.
Enable the toggle next to Pawpilot. (If it's not listed yet, click + and add it from Applications.)
Relaunch Pawpilot so the permission takes effect.

Pawpilot only reads keystroke timing to drive animations. Nothing is logged, stored, or transmitted — there's no telemetry. On Windows, no special permission is required.

Connect Claude Code

The headline trick: Pawpilot celebrates the moment your AI agent finishes. Wire it to Claude Code with a single hook so the cat knows when a run starts and stops.

Add a Stop hook to your Claude Code settings (~/.claude/settings.json) that pings Pawpilot's local listener:

~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command",
            "command": "curl -s http://127.0.0.1:4317/agent/done >/dev/null" }
        ]
      }
    ]
  }
}

That's it. When Claude Code finishes a turn, the hook fires, Pawpilot picks it up locally, and the cat does its Agent Done Jump. The same local endpoint backs the Codex, Cursor, Antigravity, and Kiro integrations — point each tool's completion hook at it.

The listener runs entirely on 127.0.0.1 — it never leaves your machine. Toggle agent reactions on or off any time from Pawpilot's settings.

Troubleshooting

“Pawpilot can't be opened” on macOS: This is the unsigned-build warning. Right-click the app → Open, or approve it under System Settings → Privacy & Security.
My key won't activate: Make sure you pasted the entire string including the PAW1. prefix, with no extra spaces or line breaks. Re-copy it from your account page.
The cat doesn't react to typing: Grant Input Monitoring (see Permissions above) and relaunch the app.
Still stuck?: Reach out from the email tied to your purchase — sign in at pawpilot.space/account.

Get Pawpilot running