Environment
Paths and environment variables the inflexa CLI reads
Paths
When $XDG_DATA_HOME / $XDG_CONFIG_HOME are unset, the bases default to ~/.local/share and ~/.config.
| Path | Location | Purpose |
|---|---|---|
| database | $XDG_DATA_HOME/inflexa/agent.db |
saved sessions (SQLite) |
| logs | $XDG_DATA_HOME/inflexa/logs |
log files, rotated daily, 7-day retention |
| references | $XDG_DATA_HOME/inflexa/refs |
reference data mounted read-only in sandboxes at /mnt/refs |
| content | $XDG_DATA_HOME/inflexa/content |
skills/templates extracted from the binary on first run, keyed by content hash |
| locks | $XDG_DATA_HOME/inflexa/locks |
advisory per-analysis instance locks |
| models | $XDG_DATA_HOME/inflexa/models |
local embedding GGUF models, downloaded by inflexa setup --embeddings |
| embedding model | $XDG_DATA_HOME/inflexa/models/bge-small-en-v1.5-q8_0.gguf |
the bge-small-en-v1.5 GGUF used by the local embedding provider |
| llama runtime | $XDG_DATA_HOME/inflexa/llama-server |
pinned llama-server runtime for local embeddings, materialized by inflexa setup --embeddings local |
| proxy config | $XDG_DATA_HOME/inflexa/cliproxy/config.yaml |
CLIProxyAPI config, mounted into the proxy container |
| proxy auth | $XDG_DATA_HOME/inflexa/cliproxy/auth |
CLIProxyAPI provider credentials, created by inflexa setup |
| postgres data | $XDG_DATA_HOME/inflexa/postgres |
Postgres data dir, bind-mounted into the inflexa-postgres container |
| compose file | $XDG_DATA_HOME/inflexa/docker-compose.yml |
Docker Compose file orchestrating the proxy and Postgres containers |
| config | $XDG_CONFIG_HOME/inflexa/config.json |
settings (telemetry consent) |
| auth | $XDG_CONFIG_HOME/inflexa/auth.json |
Auth0 session tokens, created by inflexa auth login |
| provenance key | $XDG_CONFIG_HOME/inflexa/prov_key.json |
Ed25519 keypair for signing provenance chain hashes |
Variables
| Variable | Description |
|---|---|
INFLEXA_LOG_LEVEL |
log verbosity: trace|debug|info|warn|error|fatal (default: info) |
OTEL_EXPORTER_OTLP_ENDPOINT |
OTLP endpoint for log export; requires telemetry enabled via inflexa config |
INFLEXA_MODEL_API_KEY |
API key for a direct model connection (config models.connection.mode: "direct"); unused with the default managed proxy |
XDG_DATA_HOME |
overrides the base directory for: database, logs, references, content, locks, models, embedding model, llama runtime, proxy config, proxy auth, postgres data, compose file |
XDG_CONFIG_HOME |
overrides the base directory for: config, auth, provenance key |