plannotator/herdr-annotate

What it solves

It provides a way to annotate and review text within the Herdr terminal environment, specifically targeting the interaction between users and AI agents. It allows users to comment on terminal text, review Markdown documents, and provide direct feedback to AI agents based on those annotations.

How it works

The project is a plugin for Herdr that offers two installation modes: a "Full" version that integrates the Plannotator TUI for document and agent-reply review, and a "Lite" version for simple terminal text annotations. It captures selected text via Herdr's API or system clipboard and allows users to save comments. These annotations can then be copied as context or sent directly back to an AI agent as the next message.

Who it’s for

Developers and users of AI agents (such as Claude Code, Codex, Copilot CLI, and others) who operate within the Herdr terminal and need a structured way to provide feedback or review agent outputs.

Highlights

• Dual Installation Modes: Offers a Full version for comprehensive review and a Lite version fores simple annotations.
• Agent Feedback Loop: Allows users to send reviews and annotations directly back to the agent as a message.
• TUI Integration: Integrates with plannotator-tui for structured document review.
• Cross-Platform Support: Works on macOS, Linux, and Windows.
• Neovim Integration: Includes a specific mapping to allow annotations from within Neovim visual mode.