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

Where settings live

Later ones win:

  1. NOVA's defaults
  2. ~/.nova/settings.json: your settings, for every project
  3. .nova/settings.json in your project: shared with your team (commit it)
  4. .nova/settings.local.json in your project: this computer only (don't commit it)
  5. 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

SettingValuesDefaultWhat it does
permission.modeplan, ask, acceptEdits, overdrive, autoaskHow much NOVA does without asking.
permission.allowlistemptyCommands NOVA may run without asking.
permission.denylistemptyCommands NOVA always refuses.
ignorelistemptyExtra file patterns to leave out of searches.
routing.max_iterationsnumber30The most steps in one task before NOVA stops and reports.
verify.enabledtrue / falsetrueRun your checks after a task that edits files.
verify.testcommanddetectedYour test command.
verify.buildcommanddetectedYour build command.
verify.lintcommanddetectedYour lint command.
verify.typecheckcommanddetectedYour type-check command.
git.auto_committrue / falsefalseCommit after a successful task.
git.auto_pushtrue / falsefalsePush after committing.
skills.disabledlistemptySkills to switch off.
skills.enabledlistemptyIf set, only these skills load.
repository_intelligence.enabledauto, on, offautoUse the project map when it helps.
ui.headergeneral, compactgeneralHow much the header shows.
telemetry.enabledtrue / falsetrueKeep a local usage log on your computer. Nothing is sent.
hooksobjectemptySee Hooks.
mcp.serversobjectemptySee 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.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.