Claude Code

Set it up

1. 1

   Install Plannotator.

   $ curl -fsSL https://plannotator.ai/install.sh | bash

   You should see The installer ends with CLAUDE CODE USERS: YOU'RE ALL SET!

2. 2

   Add the plugin.

   $ claude plugin marketplace add backnotprop/plannotator claude plugin install plannotator@plannotator

   You should see claude plugin list shows plannotator@plannotator.

3. 3

   Quit Claude Code and start it again. claude --continue brings back the conversation you were in.

   $ claude --continue

   You should see Claude has a plannotator_inbox tool. It needs Claude Code 2.1.287 or newer.

4. 4

   Open the Inbox. It connects the agents it finds on this computer.

   $ plannotator inbox

   You should see The Inbox opens in your browser. Settings → Agents shows Claude Code as Connected through Plannotator’s plugin.

Other ways

Check it works

Troubleshooting

Claude has no plannotator_inbox tool

Check that claude plugin list shows plannotator@plannotator and restart Claude Code. The tool needs Claude Code 2.1.287 or newer in an interactive session.

$ claude plugin list

Settings → Agents says the Claude Code mod is off

Unset PLANNOTATOR_CLAUDE_MOD=0 or remove "claudeCodeMod": false from ~/.plannotator/config.json. Then restart Claude Code.

Settings → Agents says plugin needs an update

Update the plugin and restart Claude Code.

$ claude plugin marketplace update plannotator claude plugin update plannotator@plannotator

No Send now on a reply or the sidebar says Reload Claude Code

That session runs an older plugin. Type /reload-plugins in it. If it is still listed, type /exit and start it again with the command the Inbox gives you.

$ cd <folder> && claude --resume <session id>

Your reply says Queued

Claude is working and gets the reply when its turn ends. Press Send now to put it into the running turn.

On Windows the tool never appears

The plugin needs Git Bash or a PowerShell 5.1 that may run -EncodedCommand. Constrained Language Mode or a security product can block it. PLANNOTATOR_MOD_SHELL=sh or powershell picks one.

The installer says DUPLICATE HOOK DETECTED

Remove the plannotator hook from ~/.claude/settings.json. The plugin has its own and plan review would open twice.

A session the Inbox started says Claude Code couldn’t answer

Its turn ended in an error such as low credit or a sign-in or a rate limit. The note above it says which. Fix that and press Try again to send your message again.

The Inbox doesn’t open

Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

• In claude -p and other SDK runs the plugin adds no Inbox tool and nothing wakes the session. The chat panel of Claude Code’s VS Code extension gets both.
• Starting Claude Code from the Inbox is off on Windows by default.
• Claude’s own AskUserQuestion stays in Claude Code. Questions reach the Inbox when Claude sends them there.

Examples

• Leave plan mode and the plan opens in Plannotator while Claude keeps working.
• /plannotator-review opens your changes. Your comments go back to Claude.
• Pick New Claude Code session in the Inbox to start one from there.