> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotate a Folder with Plannotator

> Open a folder of supported documents, plain-text config and data files, and HTML in one Plannotator session.

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

```bash theme={null}
plannotator annotate docs/
```

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:

```bash theme={null}
plannotator annotate docs/ --gate
```

## 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](/open-source/reference/environment-variables#files-diagnostics-and-local-tools) for the setting.

See [Annotate documents](/open-source/workflows/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.