DEEN

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

FileWhat it does
AGENTS.mdProject guidance every session reads first (alran init . writes it)
.mcp.jsonMCP servers for this project (MCP)

Environment variables

VariableWhat it doesDefault
ALRAN_API_KEYAn Ottili API key for this run; overrides the stored sign-innot set
ALRAN_DATA_DIRWhere data lives~/.alran
ALRAN_LOGIN_FLOWdevice or browser for alran auth logindecided by the terminal
ALRAN_NO_UPDATE_CHECK1 turns off the weekly update hintnot set
ALRAN_API_BASEAnother Ottili AI Gatewayhttps://ai.ottili.one/v1
OTTILI_PLATFORM_URLAnother Ottili Platform for sign-inhttps://platform.ottili.one
ALRAN_STORE_URLAddress of the default store; off switches it offOttili's store
ALRAN_PLUGIN_REGISTRY_URLA plugin registry you runnot set
ALRAN_UPDATE_SOURCEA mirror for alran updatenpm

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.