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
  • Config and data: .yaml, .yml, .json, .jsonc, .json5, .toml, .ini, .cfg, .conf, .properties, .csv, .tsv, .log, .xml, and .env.example
  • HTML: .html and .htm
A bare .env file and source-code extensions are excluded. Each file must be 2 MiB or smaller. 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. Opening an eligible local text file from the folder browser records per-file annotation history. The history remains grouped by the file’s stable path, unchanged content does not create a duplicate version, and later sessions can show a diff against a saved version. Rendered HTML, converted URLs, agent messages, and ordinary documents opened through links inside another review do not receive folder-session history.

​
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.25.0 on July 27, 2026. Maintained by the Plannotator project.
Last modified on July 27, 2026