DocsReference
Configuration and data
Where Alran Code keeps its data, and the variables that change it.
Where does Alran Code keep my data?
Sign-in, settings, provider configuration (config.yaml), sessions, plugins, caches and logs live in ~/.alran. A profile uses ~/.alran-<profile>. Keep these folders private and out of Git: config.yaml can hold API keys.
In your project
| File | What it does |
|---|---|
AGENTS.md | Project guidance every session reads first (alran init . writes it) |
.mcp.json | MCP servers for this project (MCP) |
Environment variables
| Variable | What it does | Default |
|---|---|---|
ALRAN_API_KEY | An Ottili API key for this run; overrides the stored sign-in | not set |
ALRAN_DATA_DIR | Where data lives | ~/.alran |
ALRAN_LOGIN_FLOW | device or browser for alran auth login | decided by the terminal |
ALRAN_NO_UPDATE_CHECK | 1 turns off the weekly update hint | not set |
ALRAN_API_BASE | Another Ottili AI Gateway | https://ai.ottili.one/v1 |
OTTILI_PLATFORM_URL | Another Ottili Platform for sign-in | https://platform.ottili.one |
ALRAN_STORE_URL | Address of the default store; off switches it off | Ottili's store |
ALRAN_PLUGIN_REGISTRY_URL | A plugin registry you run | not set |
ALRAN_UPDATE_SOURCE | A mirror for alran update | npm |
Telemetry
Alran Code reports no usage to any host unless ALRAN_TELEMETRY_ENDPOINT is set. alran telemetry shows what would be sent.
Common questions
Where does Alran Code keep my data?
Sign-in, settings, the provider configuration in config.yaml, sessions, plugins, caches and logs live in the folder ~/.alran. Keep this folder private and out of Git, because config.yaml can hold API keys, and a profile keeps its data in a folder of its own.
Which files belong in my project folder?
AGENTS.md holds the project guidance that every session reads first, and the command alran init . writes it. .mcp.json holds the MCP servers for this project.
Which environment variables can I set?
ALRAN_API_KEY overrides the stored sign-in for this run, ALRAN_DATA_DIR sets where the data lives, and ALRAN_LOGIN_FLOW chooses device or browser for alran auth login. ALRAN_NO_UPDATE_CHECK turns off the weekly update hint, ALRAN_API_BASE and OTTILI_PLATFORM_URL point to another gateway or platform, ALRAN_STORE_URL sets the address of the default store, ALRAN_PLUGIN_REGISTRY_URL names a registry you run, and ALRAN_UPDATE_SOURCE names a mirror for alran update. Alran Code reports no usage to any host unless you set ALRAN_TELEMETRY_ENDPOINT.