> ## 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 Markdown, MDX, text, and HTML files in one Plannotator session, move between files, and return your annotations.

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`
* 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:

```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.23.1 on July 18, 2026. Maintained by the Plannotator project.