# 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](https://help.niroai.dev/cli/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](https://help.niroai.dev/cli/reference-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](https://help.niroai.dev/cli/secrets-and-masking/) |
| Environment values and env files | One folder, on one branch, in one project | `niro env`, see [Configure a folder](https://help.niroai.dev/cli/configuring-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.