Config Files

Zeno stores all state locally. Nothing is written to a remote server.

~/.zenoai/config.json

Your saved provider choice and API key. Created on first run after you complete provider setup.

To reset this file, run npx zenoai reset. The next run will prompt you to configure a provider again.

~/.zenoai/last-report.json

The cached output from your last Zeno report. Used to avoid re-scanning when the project has not changed significantly.

To clear this file, run npx zenoai clear-report.

.zeno-history.json

Per-project refactor history. Written to the root of each project Zeno has touched. Tracks which files were reviewed, what actions were taken, and when.

Useful for keeping a record of what the agent changed and what Zeno approved or flagged.

To reset the history for the current project, run npx zenoai reset-history.

Gitignore recommendation

If you do not want to commit the project-level history file, add it to your .gitignore:

.zeno-history.json

The global config files in ~/.zenoai/ are never committed to version control.