Reference

Environment variables

OINO_* variables, provider keys and what the bash tool sees.

Configuration#

Variable Meaning
OINO_AGENT_DIR configuration directory (default ~/.oino; same as --agent-dir)
OINO_SESSION_DIR session storage directory (same as --session-dir)
OINO_OFFLINE 1/true/yes: no startup network operations (same as --offline)
OINO_CACHE_RETENTION prompt cache retention: none, short, long
OINO_DIST_EXTENSIONS override the distribution share dir for extension packages; empty disables them
OINO_DOCS_ROOT override the docs tree used by the system prompt

Provider keys#

ANTHROPIC_API_KEY (also ANTHROPIC_AUTH_TOKEN, ANTHROPIC_OAUTH_TOKEN), OPENAI_API_KEY, XAI_API_KEY, META_API_KEY, OPENROUTER_API_KEY, GROQ_API_KEY, DEEPSEEK_API_KEY, TOGETHER_API_KEY, FIREWORKS_API_KEY, CEREBRAS_API_KEY, MISTRAL_API_KEY, DEEPINFRA_API_KEY, CHUTES_API_KEY, PERPLEXITY_API_KEY, NVIDIA_API_KEY, HF_TOKEN, MOONSHOT_API_KEY, KIMI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY, AI_GATEWAY_API_KEY. Resolution order and local servers: see providers.

Exported to tools#

Commands run by the bash tool and extension subprocesses see:

Variable Value
OINO_SESSION_ID session id
OINO_SESSION_FILE session file path
OINO_PROVIDER provider of the selected model
OINO_MODEL selected model id
OINO_REASONING_LEVEL thinking level

PI_* aliases of the same values are exported for compatibility with skills written for earlier tools.

Installer#

OINO_PREFIX (install prefix), OINO_REF (release tag or git ref), OINO_FROM_SOURCE=1 (skip the release download), OINO_DIR (source checkout for the fallback build), OINO_DRY_RUN=1. See the install section of the quick start.