Plannotator
Herdr Annotate

Annotate anything in your terminal. Send it back to your agents.

Comment on any text in your terminal, review plans, specs, wikis and your agent's replies, and send the comments with a native human-in-the-loop UX.

GitHub ↗Don't use Herdr? The core is plannotator-tui, a standalone terminal app.

Full macOS · Linux
What you get

Comment on terminal text. Review plans, specs, wikis and agent replies with Plannotator TUI.

  • Comment on any terminal text: select, prefix+a
  • Review plans, specs, wikis: any Markdown file or folder, with a file tree: prefix+o
  • Review the agent's last reply: prefix+Shift+o
  • Per selection: comment, looks good, or delete
  • Send: the comments become the agent's next message
  • Ctrl-click a file://…md link to open it
  • Overlay, split, or popup placement
  • Claude Code, Codex, pi, Copilot CLI, Droid, omp, Hermes, OpenCode
  • Bundles plannotator-tui (macOS and Linux)
herdr plugin install plannotator/herdr-annotate
Watch the Full install demoKeys
Lite macOS · Linux · Windows
What you get

Comment on terminal text only. Select, press prefix+a, type. Nothing to download.

  • Comment on any terminal text: select, prefix+a
  • Manage comments: list, copy one, copy all, archive: prefix+m
  • Copy every comment as Markdown: prefix+Shift+a
  • Works over SSH and herdr --remote with two server settings
  • TypeScript only, runs on Bun; macOS, Linux, Windows
herdr plugin install plannotator/herdr-annotate/lite
Watch the Lite install demoKeys

Demo

See it in Herdr

One video per install. The Full demo covers documents first, then the agent's last reply.

Full. First a folder: select lines, add comments, press Send. Then the agent's last reply, annotated the same way. The agent receives the comments as its next message.

Watch the Lite install demo →
FullReview in placeSelect a line, then comment, mark it good, or mark it for deletion.
FullSendEach comment arrives in the agent with its line numbers and the quoted text.
LiteManageprefix+m lists your comments. Copy one, copy all, or archive them.

How it works

What you can annotate

terminal text

lite + full

Any text on screen: logs, diffs, agent output.

  1. Select the text with the mouse
  2. Press prefix+a, type the comment, press Ctrl+S
  3. prefix+Shift+a copies all comments as Markdown

documents

full

Markdown files: plans, specs, wikis, READMEs, or a whole folder.

  1. prefix+o opens the current folder with a file tree
  2. Select with the mouse or v. c comment, a looks good, d delete
  3. Press Send (or E). Comments from every file go to the agent

agent replies

full

The agent's last reply, read from its session.

  1. prefix+Shift+o opens the agent's last reply
  2. Comment on it the same way as a document
  3. Press Send. The comments go back to the same session

Agent replies work with Claude Code, Codex, pi, Copilot CLI, Droid, omp, Hermes and OpenCode. Ctrl-click a file://…md link to open that file. The review opens as an overlay, a split, or a popup; set it in ~/.config/plannotator-tui/config.toml.

Setup

Bind the keys.

Required. The plugin does not add key bindings. Copy one block into ~/.config/herdr/config.toml.

full install keysterminal + documents + agent replies 
# Terminal annotations
[[keys.command]]
key = "prefix+a"
type = "plugin_action"
command = "annotate.capture"
description = "annotate text"

[[keys.command]]
key = "prefix+shift+a"
type = "plugin_action"
command = "annotate.copy-context"
description = "copy annotations as context"

[[keys.command]]
key = "prefix+m"
type = "plugin_action"
command = "annotate.manage"
description = "manage annotations"

# Document review (plannotator-tui)
[[keys.command]]
key = "prefix+o"
type = "plugin_action"
command = "annotate.open"
description = "review documents in this folder"

[[keys.command]]
key = "prefix+shift+o"
type = "plugin_action"
command = "annotate.last"
description = "review the agent's last reply"
lite install keysterminal annotations only 
[[keys.command]]
key = "prefix+a"
type = "plugin_action"
command = "annotate.capture"
description = "annotate text"

[[keys.command]]
key = "prefix+shift+a"
type = "plugin_action"
command = "annotate.copy-context"
description = "copy annotations as context"

[[keys.command]]
key = "prefix+m"
type = "plugin_action"
command = "annotate.manage"
description = "manage annotations"

Then run herdr config check and herdr server reload-config. Remote sessions need two settings on the server; see the README.

Built on

Plannotator TUI works without Herdr.

The document review is Plannotator TUI, a standalone program written in Rust. Open a plan, a spec, a wiki page or a whole folder, add comments, and export them as Markdown for any agent. It runs in any terminal.

$ brew trust plannotator/tap && brew install plannotator/tap/plannotator-tui
$ cargo install plannotator-tui
$ plannotator-tui plan.md
Plannotator TUI