# Settings

<!-- Generated by scripts/gen-readme-tables.mjs. Edit package.json instead. -->

| Setting | Default | Description |
|---|---|---|
| `openfiles.mode` | `"open"` | What to do when an agent edits a file. (`open`, `queue`, `notify`) |
| `openfiles.openInBackground` | `true` | Open changed files without stealing focus from the terminal or the file you're in. |
| `openfiles.maxAutoOpen` | `15` | Stop auto-opening after this many files in a session; the rest are listed in AI Edits. `0` never auto-opens. |
| `openfiles.closeReviewedTabs` | `false` | Close a file's tab when you mark it as reviewed. |
| `openfiles.ignore` | `["**/.git/**","**/.openfiles/**","**/node_modules/**","**/dist/**","**/build/**","**/out/**","**/coverage/**","**/.next/**","**/.dart_tool/**","**/target/**","**/bin/**","**/obj/**","**/__pycache__/**","**/.venv/**","**/*.log","**/package-lock.json","**/pnpm-lock.yaml","**/yarn.lock","**/bun.lock","**/Cargo.lock","**/poetry.lock","**/.claude/**","**/.codex/**","**/.gemini/**","**/.cursor/**"]` | Glob patterns that are never tracked. `files.exclude` and `.gitignore` are respected too. |
| `openfiles.sensitive` | `["**/.env","**/.env.*","**/*.pem","**/*.key","**/*.pfx","**/*.p12","**/credentials.*","**/secrets/**"]` | Glob patterns that are tracked but never opened automatically (secrets, keys). |
| `openfiles.detection.watcher` | `true` | Detect files changed on disk by anything other than this editor. |
| `openfiles.detection.git` | `true` | Use the Git extension to find uncommitted changes and to ignore branch switches. |
| `openfiles.detection.hooks` | `true` | Read edits reported by agent hooks (`.openfiles/queue.jsonl`). |
| `openfiles.detection.burstLimit` | `200` | If more files than this change within 2 seconds (installs, builds, checkouts), list them instead of opening them. |
| `openfiles.detection.editorSaveGraceMs` | `1500` | Changes within this many milliseconds of a save in the editor are treated as yours, not the agent's. |
| `openfiles.diagnostics.export` | `true` | Write problems for AI-edited files to `.openfiles/diagnostics.json` so agents can read them. |
| `openfiles.hooks.feedback` | `"errorsAndWarnings"` | What agent hooks send back to the agent after an edit. (`errors`, `errorsAndWarnings`, `off`) |
| `openfiles.hooks.feedbackTimeoutMs` | `4000` | How long a hook waits for language servers before letting the agent continue. |
| `openfiles.statusBar.enabled` | `true` | Show OpenFiles in the status bar. |
| `openfiles.statusBar.items` | `["unreviewed","errors","warnings"]` | What the status bar item shows, in order. |
| `openfiles.statusBar.clickAction` | `"menu"` | What clicking the status bar item does. (`menu`, `reviewNext`, `openAiEdits`, `showProblems`, `focusSidebar`) |
| `openfiles.statusBar.alignment` | `"left"` | Which side of the status bar to use. (`left`, `right`) |
| `openfiles.configFile` | `".openfiles.json"` | Workspace-relative path of the profiles file. |
| `openfiles.heartbeatSeconds` | `5` | How often the list of open tabs is published to `.openfiles/vscode/` for agents and hooks. |