Configuration Reference
Every config field and environment variable. For a guided version, see Configuration.config.json
Per-presence, at os-data/presences/<id>/config.json (or os-data/config.json single-tenant).
| Field | Type | Purpose |
|---|---|---|
defaultProvider | string | Active provider id: bor, anthropic, openai, gemini, openai-compatible. |
providers | object | Map of providerId → { apiKey, model, baseUrl }. |
aiName | string | What the presence calls itself. |
personality | string | Persona injected into the system prompt. |
baseTheme | string | Active theme id. |
avatar | object | DiceBear avatar config. |
onboarded | boolean | Whether onboarding completed. |
API keys live here until the planned Keychain migration. Treat os-data/ as sensitive.
Environment variables
Networking & data
| Variable | Default | Purpose |
|---|---|---|
PORT | 7777 | Runtime HTTP port. |
BOR_DATA_DIR | os-data/ | Per-presence data root (the v2 host sets os-data/presences/<id>/). |
BOR_RUNTIME_URL | — | Attach the v2 host to an already-running runtime. |
BOR_PRESENCE_ID | — | The presence id this runtime serves. |
Chat loop
| Variable | Purpose |
|---|---|
BOR_CHAT_MAX_PASSES | Max tool-use passes per turn (safety ceiling). |
BOR_CHAT_STREAM_ATTEMPTS | Stream retry attempts. |
BOR_TOOL_MAX_ATTEMPTS | Per-tool retry attempts on transient failure. |
BOR_STREAM_IDLE_TIMEOUT_MS | Idle timeout before a stalled stream retries. |
LLM harness
| Variable | Purpose |
|---|---|
BOR_LEGACY_LLM=1 | Force the legacy XML-tool harness (the default path). |
BOR_NEW_LLM=1 | Opt into the native-tool-calling harness (experimental). |
Browser
| Variable | Purpose |
|---|---|
BOR_BROWSER_HEADLESS=1 | Run the user-facing Browser app headless. |
BOR_BROWSER_EXECUTABLE_PATH | Specific Chrome/Chromium binary. |
BOR_BROWSER_CHANNEL | e.g. chrome. |
BOR_BROWSER_DATA_DIR | Browser data root. |
BOR_BROWSER_USER_DATA_DIR | The automation profile dir. |
BOR_USER_BROWSER_USER_DATA_DIR | The user-facing Browser profile dir. |
BOR_USER_BROWSER_DOWNLOADS_DIR | Downloads dir for the Browser app. |
BOR_BROWSER_OUTPUT_DIR | MCP browser output dir. |
MCP
| Variable | Default | Purpose |
|---|---|---|
BOR_MCP_MARKETPLACE_URL | https://api.cline.bot/v1/mcp | Marketplace catalog source. |
Host control (v2)
| Variable | Purpose |
|---|---|
BOR_HOST_CONTROL_URL | The Electron host’s local control server URL (runtime → host callbacks). |
BOR_HOST_CONTROL_TOKEN | Auth token for the control server. |
Config files (non-JSON)
| Path | Purpose |
|---|---|
.bor/mcp.json | Per-presence MCP servers (marketplace + AI write here). |
.bed-of-roses/mcp/servers.json | Shared MCP config. |
~/.bed-of-roses/mcp/servers.json | Global MCP config. |
.bed-of-roses/skills/ | Project skills (Markdown). |
~/.bed-of-roses/skills/ | Global skills. |
design-guideline/<theme>.md | Theme handbooks. |
server/api-registry.md | Public web APIs the model is told about. |