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

# Configuration

> Local paths and environment variables used by Termyte.

# Configuration

`termyte init` writes `~/.termyte/config.json`. Environment variables can override runtime values.

## Storage

| Variable       | Default                 | Purpose                               |
| -------------- | ----------------------- | ------------------------------------- |
| `TERMYTE_HOME` | `~/.termyte`            | Config and default database directory |
| `TERMYTE_DB`   | `~/.termyte/termyte.db` | SQLite database path                  |

## Memory processing

| Variable               | Default                     | Purpose                    |
| ---------------------- | --------------------------- | -------------------------- |
| `TERMYTE_LLM_BASE_URL` | `https://api.openai.com/v1` | OpenAI-compatible endpoint |
| `TERMYTE_LLM_API_KEY`  | empty                       | Endpoint credential        |
| `TERMYTE_LLM_MODEL`    | `gpt-4o-mini`               | Processing model           |

`OPENAI_BASE_URL` and `OPENAI_API_KEY` are fallback names. API mode requires `TERMYTE_LLM_API_KEY` or `OPENAI_API_KEY` during setup.

## Local embeddings

| Variable                    | Default       | Purpose                          |
| --------------------------- | ------------- | -------------------------------- |
| `TERMYTE_EMBED_MODEL_LOCAL` | `nomic-embed` | Use `nomic-embed` or `bge-small` |

Unknown values fall back to `nomic-embed`. Model files may be downloaded on first use.

## Runtime and integration paths

| Variable              | Purpose                                                       |
| --------------------- | ------------------------------------------------------------- |
| `TERMYTE_AUTO_WORKER` | Set to `0` to prevent hooks from starting the detached worker |
| `TERMYTE_HOOK_PATH`   | Override the installed `termyte-hook` entry path              |
| `TERMYTE_WORKER_PATH` | Override the background worker entry path                     |
| `OPENCODE_CONFIG_DIR` | Override the OpenCode configuration directory                 |

Environment variables must be visible to the coding-agent process. Setting one in another terminal does not change an agent that is already running.