Ignore files
Ignore files keep files away from the agent (secrets, generated code, vendored folders) or just out of search. They use .gitignore syntax and live in the project's .ingot/ folder, with everything else Ingot keeps in the project.
The two files
| File | What it does |
|---|---|
.ingot/ignore | the agent cannot read, list, search or edit these files, and they are hidden from @ mentions |
.ingot/indexing-ignore | the files stay usable, but are left out of the file index (quick open) |
Use .ingot/ignore for anything the agent must never see. Use .ingot/indexing-ignore for large or noisy files you still want the agent to open when you ask.
Older projects
Projects from before this change may have .ingotignore and .ingotindexingignore at the project root. They still work. When a project has both, the .ingot/ file wins and the root file is not read. Ingot never moves or deletes the root files. When Ingot creates .ingot/ignore itself (for example while importing existing editor rules), it starts from the root file's lines, so nothing is lost. A sub-folder can have its own .ingot/ignore, just like a nested .ingotignore.
Examples
# .ingot/ignore
.env*
secrets/
*.pem
infra/terraform.tfstate
# keep the example config visible
!.env.example
# .ingot/indexing-ignore
dist/
coverage/
**/*.min.js
fixtures/large-dataset.json
Syntax
The same rules as .gitignore:
| Pattern | Matches |
|---|---|
# comment | nothing; comment line |
*.log | any .log file in any folder |
/build | build at the project root only |
logs/ | folders named logs (not files) |
src/**/generated/ | generated folders at any depth under src |
!keep.log | re-includes a file an earlier line excluded (last match wins) |
What each file affects
| Where | .ingot/ignore | .ingot/indexing-ignore |
|---|---|---|
| Agent reads a file | blocked | allowed |
| Agent edits a file | skipped | allowed |
| Agent lists, globs or greps | hidden | allowed |
@ picker and @ mentions in a prompt | hidden / dropped | allowed |
| Quick open | hidden | hidden |
| Find in Files | excluded | included |
When the agent tries to read an ignored file it gets a clear error ("secrets/prod.json" is in the ignore file (.ingot/ignore): agents cannot read it.) instead of the contents, so it knows not to retry.
.ingot/ignore limits Ingot's own file tools. A shell command the agent runs (for example cat .env) is not filtered. To stop those, add a beforeShellExecution hook (Hooks) or keep the approval prompt for commands on.Compatibility
Ignore files from existing editors at the project root are read too and combined with Ingot's, while the project keeps its existing setup. Convert to .ingot merges them into .ingot/ignore and .ingot/indexing-ignore instead (Import an existing setup).
Your .gitignore is respected as well: the agent's list, glob and grep tools skip git-ignored files.