Settings reference

Settings files are JSON with comments and trailing commas allowed. For completion and validation in your editor, add:

{ "$schema": "<settings-schema-url>" }

Layers

From lowest to highest precedence:

Objects merge key by key; later layers win. These lists are combined across layers instead of replaced: permissions.allow, permissions.ask, permissions.deny, permissions.additionalDirectories, sandbox.writablePaths and webFetch.deniedDomains.

A managed layer locks every top-level key it sets. Some keys are honoured only in certain layers; the table below says so.

Keys

Voice input

/voice records from the microphone until you stop talking (about 1.5 seconds of silence) or a time limit, transcribes the recording and sends the text as your next message. Audio is sent only to the provider named in voice.provider; nothing is sent unless voice is set.

"voice": {
  "provider": "openai",   // an OpenAI-compatible provider (OpenAI, Groq, a local whisper server) or Gemini
  "model": "whisper-1",
  "language": "en",       // optional ISO-639-1 hint
  "maxSeconds": 60,       // longest recording (default 60)
  "silenceMs": 1500,      // quiet after speech that ends the recording (default 1500)
  "device": "hw:1"        // optional input device
}

Recording uses a program already on the system: SoX (rec) or ffmpeg on macOS; arecord, ffmpeg or SoX on Linux; ffmpeg on Windows. The audio is kept in a temporary WAV file only until it is transcribed.

Move settings between machines

neuralinverse settings export bundle.json         # settings, keybindings, commands, agents, skills, styles
neuralinverse settings import bundle.json         # merged into ~/.neuralinverse (--replace overwrites settings)
neuralinverse settings sync --repo git@host:me/ni-settings.git   # two-way sync; the URL is remembered

Bundles and the sync repository never contain secrets: apiKey, every headers map, OAuth clientSecret and secret-looking env entries are removed, and only the files listed above are copied (never credentials, sessions, caches, logs or plugins). Importing keeps this machine's keys. Sync clones the repository into ~/.neuralinverse/sync, copies changes in the right direction, commits and pushes. When a file changed on both sides, this machine's copy wins; for settings.json both versions are merged, this machine's values winning.

Environment variables

Provider credential variables are listed in Providers and models.

Files written