Skip to main content
Pass a folder to plannotator annotate to browse and annotate its supported documents in one session. This works well for a documentation folder or a local knowledge base containing plans, PRDs, specifications, ADRs, RFCs, and notes.

​
Open the folder

Plannotator starts a temporary local server and opens the folder file browser. The files remain on your computer. The browser lists these file types:
  • Markdown: .md and .mdx
  • Text: .txt
  • HTML: .html and .htm
Common generated and dependency directories, including node_modules, dist, and build, are skipped.

​
Move between files

Choose a file in the browser, add annotations, then choose another file. You do not need to start a new Plannotator session for each document. Press Mod + Shift + B to show or hide the folder browser. Mod means Command on macOS and Control on Windows and Linux.

​
Send the folder feedback

Select Send Feedback after you finish annotating. A direct terminal run prints the formatted feedback to standard output. A supported agent command or skill returns it to the active agent session. Use --gate when the folder review also needs an Approve action:

​
Open a large folder

The file browser returns up to 5,000 supported files by default. Set PLANNOTATOR_FILE_BROWSER_MAX_FILES to a positive integer when you need a different limit. See Environment Variables for the setting. See Annotate documents for local-file editing, web URLs, HTML rendering, and save behavior. Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026