Back
Configuration // Settings
Settings
Docs › Configuration › Settings
Settings
Change how NOVA behaves for you, for a project, or for your whole team.
View and change settings
bash
nova config list # everything, and where each value comes from
nova config get permission.mode # one setting
nova config set permission.mode acceptEdits # this project, shared with your team
nova config set permission.mode acceptEdits --local # this project, this computer only
nova config set ui.header compact --user # all your projects
nova config get permission.mode # one setting
nova config set permission.mode acceptEdits # this project, shared with your team
nova config set permission.mode acceptEdits --local # this project, this computer only
nova config set ui.header compact --user # all your projects
Where settings live
Later ones win:
- NOVA's defaults
~/.nova/settings.json: your settings, for every project.nova/settings.jsonin your project: shared with your team (commit it).nova/settings.local.jsonin your project: this computer only (don't commit it)- Command-line options, like
--permission-mode
If one value is invalid, NOVA skips just that value and tells you. If you misspell a key, NOVA suggests the right one.
Settings you can change
| Setting | Values | Default | What it does |
|---|---|---|---|
| permission.mode | plan, ask, acceptEdits, overdrive, auto | ask | How much NOVA does without asking. |
| permission.allow | list | empty | Commands NOVA may run without asking. |
| permission.deny | list | empty | Commands NOVA always refuses. |
| ignore | list | empty | Extra file patterns to leave out of searches. |
| routing.max_iterations | number | 30 | The most steps in one task before NOVA stops and reports. |
| verify.enabled | true / false | true | Run your checks after a task that edits files. |
| verify.test | command | detected | Your test command. |
| verify.build | command | detected | Your build command. |
| verify.lint | command | detected | Your lint command. |
| verify.typecheck | command | detected | Your type-check command. |
| git.auto_commit | true / false | false | Commit after a successful task. |
| git.auto_push | true / false | false | Push after committing. |
| skills.disabled | list | empty | Skills to switch off. |
| skills.enabled | list | empty | If set, only these skills load. |
| repository_intelligence.enabled | auto, on, off | auto | Use the project map when it helps. |
| ui.header | general, compact | general | How much the header shows. |
| telemetry.enabled | true / false | true | Keep a local usage log on your computer. Nothing is sent. |
| hooks | object | empty | See Hooks. |
| mcp.servers | object | empty | See MCP Servers. |
Example
.nova/settings.json
{
"permission": { "mode": "acceptEdits" },
"verify": { "test": "pytest -q" },
"ignore": ["dist/**", "*.log"]
}Tip:An "allow always" answer is saved in
.nova/settings.local.json, so your choice never widens permissions for your whole team.Join our Discord
Chat with our engineers and become part of the active NOVA developer community.
Need help?
Open an issue on GitHub or email support@bridgeye.com.