nota

A local annotation tool for AI agent implementation plans.

nota opens a Markdown plan in a browser-based editor where you can highlight text and leave comments using CriticMarkup. The agent reads those comments back and adjusts the plan or implementation accordingly.

Install

npm install -g nota

Usage

Annotate a plan

nota path/to/plan.md

Opens the file in a local web UI. Highlight any text to leave a comment. When you're done, click Done — the agent reads the annotated file and processes your feedback.

Pass --no-open to start the server without opening the browser automatically:

nota --no-open path/to/plan.md

Set up agent instructions

nota init          # choose agents interactively
nota init all      # all agents, non-interactive
nota init claude   # Claude only
nota init codex    # Codex only
nota init cursor   # Cursor only

The interactive mode starts with no agents selected, so you explicitly choose the agent instructions to install.

Writes the annotation workflow instructions into CLAUDE.md, AGENTS.md, or .cursor/rules/nota.mdc. Safe to re-run — existing files are updated in place, not overwritten.

How it works

1. The agent creates a plan as .agent-plans/<date>-<topic>.md and runs nota on it
2. You annotate the plan in the browser
3. Feedback is stored as CriticMarkup inline in the file:

   {==highlighted text==}{>>your comment<<}

4. The agent reads the annotations and updates the plan or proceeds with implementation

License

MIT