herdr-annotate
Annotate terminal text, review documents and agent replies, and pipe feedback straight back to agents.
Bridge terminal text, document reviews, and AI agent prompts inside Herdr with precise inline feedback.
herdr-annotate is a Rust-based plugin for Herdr that lets you annotate terminal text, review Markdown documents, and pipe your feedback directly back to AI agents. It is designed for developers and legal tech engineers who want tight, deterministic control over AI agent workflows within their terminal environment.
What it is
The tool wraps plannotator-tui to provide comment popovers, document viewing, and archive management directly inside Herdr panes. You can capture terminal selections, package them as Markdown, and send them straight to active agent prompts or clipboard via OSC 52.
Who it's for
It suits technical professionals, legal engineers, and developers working heavily with CLI-based AI coding agents or legal automation CLIs inside Herdr. It does not suit non-technical users or those who do not use the Herdr terminal multiplexer.
Key features
Terminal Text Annotation
Select terminal output and comment on it using quick popovers.
Direct Agent Hand-off
Send compiled annotation archives straight into the focused agent's prompt.
Document & Reply Review
Review Markdown documents and agent replies using plannotator-tui.
OSC 52 Clipboard Support
Copy annotations to your local machine's clipboard automatically over remote sessions.
Up and running in 3 steps
Our honest verdict
What's great
- Feeds annotations back to AI agents in the exact chronological order you wrote them.
- Supports remote sessions via OSC 52 clipboard fallback on Herdr 0.9.0.
- Offers both a lightweight terminal-only install and a full document-review variant.
- Prevents accidental prompt injection by verifying if the agent is ready before sending.
Where it falls short
- Requires manual TOML keybinding and configuration edits in Herdr.
- Remote SSH usage requires explicitly disabling Herdr's default copy_on_select behavior.
- Windows full variant support is currently a preview requiring Herdr 0.9.0.
Pricing & license
The software is free under its open-source license, with no paid hosted option provided. The only cost is running it yourself on your local machine or remote server.
Open remote AI-training roles
880 open remote AI-training roles, updated November 15, 2026; most pay $20–$175 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
Use it, or have us set it up
FAQ
What is the difference between Full and Lite installs?
The Full install includes terminal annotation plus document and agent-reply review powered by plannotator-tui. The Lite install handles terminal annotations only.
Does it work over remote SSH sessions?
Yes, but you must configure `copy_on_select = false` in your remote Herdr config and use OSC 52-compatible actions.
Which AI agents are compatible with the document review feature?
It works with Claude Code, Codex, pi, Copilot CLI, Droid, Oh My Pi, Hermes CLI, and OpenCode.
