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.