> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tai config

> Read and update server configuration.

Read and update server configuration.

```console theme={null}
$ tai config [OPTIONS] COMMAND [ARGS]...
```

## `tai config env`

Read and update the stored env overrides.

```console theme={null}
$ tai config env [OPTIONS] COMMAND [ARGS]...
```

### `tai config env get`

Read the stored env config and the operator's secret-key marks.

Example: `tai config env get`

```console theme={null}
$ tai config env get [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

### `tai config env set`

Merge KEY=VALUE env overrides and hot-reload the process config.

Example: `tai config env set LOG_LEVEL=debug FEATURE_X=1`

```console theme={null}
$ tai config env set [OPTIONS] ASSIGNMENT...
```

| Argument        | Description                                                |
| --------------- | ---------------------------------------------------------- |
| `ASSIGNMENT...` | One or more KEY=VALUE env overrides to merge. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai config lint`

Lint config OFFLINE: a manifest file's shape plus required-settings resolution.

Validates the manifest file against the `Manifest` model (a broken manifest
fails loudly with the model error) and checks that every required registered
setting resolves from the environment. No server is started.

Example: `tai config lint config/manifest.yml`

```console theme={null}
$ tai config lint [OPTIONS] [FILE]
```

| Argument | Description                                                                         |
| -------- | ----------------------------------------------------------------------------------- |
| `[FILE]` | Manifest file to validate; defaults to \$TAI\_MANIFEST\_PATH when set. *(optional)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai config mode`

Read the active config backend mode (file / k8s).

Example: `tai config mode`

```console theme={null}
$ tai config mode [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai config reload`

Soft-restart this process from its manifest, fanning out to every worker.

Refreshes env, resets settings caches, and re-initializes from the manifest
in-process (no pod restart), then propagates to the fleet; `--target` restricts
the fan-out to named workers.

Example: `tai config reload`

```console theme={null}
$ tai config reload [OPTIONS]
```

| Option                 | Description                                      |
| ---------------------- | ------------------------------------------------ |
| `--target` `TEXT`      | A worker to restrict the reload to (repeatable). |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.           |

## `tai config settings-schema`

List the registered settings groups with their resolved field values.

Example: `tai config settings-schema --json`

```console theme={null}
$ tai config settings-schema [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |