Settings files
Most people never edit these. The commands write them for you. They are listed so that you know what each holds. The full list of files is in Where things are stored.
~/.niro/config.json
| Key | What it holds | Default |
|---|---|---|
apiUrl |
The account service address | https://aiorchestrator.niroai.dev |
billingUrl |
The licence and engine-download service | https://billing.cloud.niroai.dev |
auditUrl |
Where the coverage audit is sent | https://audit.cloud.niroai.dev |
mcpServerUrl |
Where the tool-usage record is sent. Saved only when you pass --url to niro mcp install |
https://aiassistant.niroai.dev |
appUrl |
The console you signed in through, used for links such as the limit page | https://console.niroai.dev |
mcpConnectedAt |
When niro start connected your agents |
none |
mcpMode |
Hosted or local. Only used by hosted Niro releases | none |
cloudIndexingApproved |
Left from older versions. No longer read | none |
An environment variable with the same purpose wins over this file. One exception: once you are signed in, the account address saved with your sign-in (in credentials.json) wins over NIRO_API_URL. See Environment variables.
~/.niro/credentials.json
Your sign-in. Readable by you only. Do not edit it: niro login and niro logout manage it.
Engine settings
| Setting | Where | How to change it |
|---|---|---|
show-config-values (on or off; default off) |
One folder, or the whole computer | The engine's config set, see Secrets and masking |
| Environment values and env files | One folder, on one branch, in one project | niro env, see Configure a folder |
| The service address (base URL) | One folder or service | niro base-url |
| Route rules | One folder | niro route-rule |
All of these live in ~/.niro-local/registry.db.
Files written into coding agents
Each agent's page lists the files niro mcp install writes into that agent's settings. Niro ignores an agent settings file larger than 4 MB.