Annotate Markdown in the terminal: select text, comment, 👍 looks good, ✗ delete. A standalone app, and a Herdr plugin that knows how to open it.
crates/plannotator-tui-schema- annotation and anchor types, wire-compatible with Plannotator Workspaces (phase 1).crates/plannotator-tui- the TUI application.herdr/- the Herdr plugin manifest;skills/- the agent skill.samples/- documents for development and benchmarks.
cargo build --release
./target/release/plannotator-tui samples/plugins.mdLink the plugin once (herdr plugin link ./herdr), build it (cargo build --release), and
bind a key:
# ~/.config/herdr/config.toml
[[keys.command]]
key = "prefix+a"
type = "plugin_action"
command = "plannotator-tui.open"
[[keys.command]]
key = "prefix+shift+d"
type = "plugin_action"
command = "plannotator-tui.last"prefix+a opens the focused pane's folder for review; Ctrl-click on a file://…md link an
agent printed opens that file; an agent runs plannotator-tui herdr open <file> from its own pane
(see skills/plannotator-tui/SKILL.md). In every case the header button says where feedback goes
— Send 3 to claude in w1:p2 ▸ — and clicking it (or E) makes the review the agent's next
message. Where plannotator-tui opens is yours to choose:
# ~/.config/plannotator-tui/config.toml
[herdr]
placement = "overlay" # overlay (full tab, default) | split | popupplannotator-tui config prints the file's path and the values in effect.
plannotator-tui last finds the transcript of the agent that launched your shell (Claude
Code, Codex, pi, GitHub Copilot CLI, or Droid), shows a picker of its recent replies, and opens
the one you choose as a
document you can annotate and send back — nothing is written to disk. In Herdr, bind
plannotator-tui.last (prefix+shift+d above) and press it in the agent's pane. For
scripts and hooks, plannotator-tui last --print writes the newest reply to stdout and
always exits 0; --session <transcript> skips detection and --stdin reads a document
from stdin.
See crates/plannotator-tui/README.md for keys, headless tools, and measurements;
docs/decisions.md for the design record; AGENTS.md for engineering rules.
