.env.example

# VoidCode environment example
#
# Copy this file to `.env` (gitignored) and fill in only the keys you need.
# All variables are optional; runtime defaults apply when a variable is unset.

# ─── Runtime configuration ───────────────────────────────────────────────────
# Default model used when --model is not provided on the CLI.
# Format: "<provider>/<model>" (e.g. "opencode-go/glm-5", "anthropic/claude-3-5-sonnet").
VOIDCODE_MODEL=

# Approval mode for write/edit/shell tools: ask | deny | allow
VOIDCODE_APPROVAL_MODE=

# Execution engine: provider | deterministic
# Use `deterministic` for offline/test/no-key harness flows.
VOIDCODE_EXECUTION_ENGINE=

# Hard upper bound on graph steps per request.
VOIDCODE_MAX_STEPS=

# Per-tool timeout in seconds.
VOIDCODE_TOOL_TIMEOUT_SECONDS=

# Reasoning effort hint forwarded to providers that support it: low | medium | high
VOIDCODE_REASONING_EFFORT=

# Override the persistent session SQLite path.
# Default: $XDG_STATE_HOME/voidcode/sessions.sqlite3
VOIDCODE_DB_PATH=

# ─── Provider credentials ────────────────────────────────────────────────────
# Provide whichever providers you intend to use; leave the rest unset.

# OpenCode-Go (default product path in README)
OPENCODE_API_KEY=

# Anthropic Claude
ANTHROPIC_API_KEY=

# OpenAI
OPENAI_API_KEY=

# Google Gemini
GOOGLE_API_KEY=

# GitHub Copilot
GITHUB_COPILOT_TOKEN=

# LiteLLM proxy (default base http://127.0.0.1:4000 — dev only)
LITELLM_API_KEY=

# Z.AI / GLM
GLM_API_KEY=

# Moonshot Kimi
KIMI_API_KEY=

# MiniMax
MINIMAX_API_KEY=

# Aliyun Dashscope
DASHSCOPE_API_KEY=

# DeepSeek
DEEPSEEK_API_KEY=

# ─── Search / capability credentials ─────────────────────────────────────────
# Exa.ai (powers the built-in web_search tool when set; falls back to DuckDuckGo otherwise).
EXA_API_KEY=