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.
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.
Select the text with the mouse
Press prefix+a, type the comment, press Ctrl+S
prefix+Shift+a copies all comments as Markdown
documents
full
Markdown files: plans, specs, wikis, READMEs, or a whole folder.
prefix+o opens the current folder with a file tree
Select with the mouse or v. c comment, a looks good, d delete
Press Send (or E). Comments from every file go to the agent
agent replies
full
The agent's last reply, read from its session.
prefix+Shift+o opens the agent's last reply
Comment on it the same way as a document
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"
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.