# backnotprop/plannotator

> plannotator is a local, browser-based review surface for AI coding agents such as Claude Code, Codex, and Gemini CLI. Developers use it to annotate plans, specs, documents and code diffs, then send their feedback back to the agent. It connects to agents through plugins, hooks and commands, and its primary language is TypeScript.

Source: https://github.com/backnotprop/plannotator
Indexed: commit 5fb90d0 on 2026-11-17 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: TypeScript
- Stars: 14,280 at index time
- License: Apache-2.0
- Code health: 7.3/10, Good
- Last commit: 2026-11-17
- Contributors: 180

## How it works

Input enters through agent-specific entry points, such as apps/hook/server/cli.ts for hooks, apps/opencode-plugin/server.ts for OpenCode and apps/pi-extension/server.ts for Pi. When an agent proposes a plan or finishes work, the review app opens in the browser. The build directory packs the review, hook and inbox front ends into single HTML pages, with build/pack-app.ts supplying the review and hook builds. The packages directory holds most of the code, including packages/inbox/App.tsx for the Inbox interface and packages/server/inbox.ts for its server side. The user's annotations and comments are sent back to the agent, which acts on them. The bin directory contains the command-line entry point.

- apps/dsh-plugin/cli.ts: entry point
- apps/guides-show/viewer/main.tsx: entry point
- apps/hook/server/cli.ts: entry point
- apps/opencode-plugin/server.ts: entry point
- apps/pi-extension/server.ts: entry point
Modules: packages, apps, tests, scripts, build, spec, bin. 6,428 files, 1,158,181 lines, 60,653 symbols.

## Code health

- Score: 7.3/10 (Good)
- Rank: #124 of 4,000+ indexed repos
- Hotspots: packages/inbox/components/Thread.tsx, packages/inbox/App.tsx, packages/shared/inbox/store.ts, packages/server/inbox.ts, packages/editor/App.tsx
- Lowest file: packages/core/shape.ts
- Dead code: 40 findings

## Maintenance

- Last commit 2026-11-17, 5,942 commits
- 180 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/backnotprop/plannotator/security

## More

- Page: https://repowise.dev/repo/backnotprop/plannotator
- Ask this codebase: https://repowise.dev/repo/backnotprop/plannotator/chat
- Docs: https://repowise.dev/repo/backnotprop/plannotator/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/backnotprop/plannotator
