All agents

GitHub Copilot CLI

The plugin opens Copilot CLI’s plans in Plannotator. You connect the Inbox by hand.

Hooks and MCP · Plannotator’s hooks and commands plus the Inbox through MCP

Set it up

  1. Install Plannotator.

    curl -fsSL https://plannotator.ai/install.sh | bash
  2. In Copilot CLI add the plugin. Then restart Copilot CLI.

    /plugin marketplace add backnotprop/plannotator /plugin install plannotator-copilot@plannotator
  3. Add the Inbox to Copilot CLI as a stdio MCP server named plannotator-inbox that runs this command. Plannotator has no step for Copilot CLI yet: use its own MCP settings.

    plannotator inbox mcp

Other ways

On Windows

Install Plannotator from PowerShell. The other steps are the same.

irm https://plannotator.ai/install.ps1 | iex

Check it works

Paste this into Copilot CLI.

Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it.

You should see A question arrives in the Inbox. Answer it and press Send. Tell Copilot CLI you sent it and it reads your answer.

Troubleshooting

Plan review doesn’t open

Restart Copilot CLI after you add the plugin. Plan mode is Shift+Tab.

/plannotator-last fails

It reads Copilot’s session log, whose format can change between versions. Update Plannotator.

The plannotator-inbox server fails to start

An app started from the Dock may not see your shell’s PATH. Put the full path to plannotator in the config. which plannotator prints it.

Your reply never shows up in the session on its own

Nothing can wake Copilot CLI: it sees a reply when it reads the thread. Tell it to check the Inbox.

What works

  • Inbox tool MCP by hand
  • Reply wakes it Not woken
  • Start from Inbox No
  • Permission cards No
  • Plan review Yes
  • Code review Yes
  • Annotate Files and last reply
  • Ask this session No

Examples

  • Press Shift+Tab for plan mode and review the plan in Plannotator.

Every agent Full GitHub Copilot CLI guide

Built by

With contributions from