Skip to content

Repository files navigation

Plannotator TUI

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.

Run

cargo build --release
./target/release/plannotator-tui samples/plugins.md

Inside Herdr

Link 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 | popup

plannotator-tui config prints the file's path and the values in effect.

Review the agent's last message

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.

About

Annotate Markdown in the terminal: select, comment, looks-good, delete; send the review to your agent.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages