Environment Variables Reference¶
Knowledge Base¶
KB_EMBEDDING_MODEL¶
Type: String
Default: sentence-transformers/all-MiniLM-L6-v2
Description: Sentence-transformers model for KB embeddings
Example:
Codex Configuration¶
CODEX_BIN¶
Type: Path
Default: codex (from PATH)
Description: Path to Codex CLI binary
CODEX_MODEL¶
Type: String Default: (uses Codex default) Description: Override Codex model selection
CODEX_TIMEOUT¶
Type: Integer (seconds)
Default: 120
Description: Timeout for Codex CLI commands
CODEX_EXPECT_JSON¶
Type: Boolean (0 or 1)
Default: 0
Description: Expect JSON output from Codex
Claude Configuration¶
CLAUDE_USE_SDK¶
Type: Boolean (1, true, yes, on = True)
Default: True
Description: Use Claude SDK (API) vs CLI fallback
CLAUDE_MEMORY_DIR¶
Type: Path
Default: .claude/memory
Description: Directory for agent memory persistence
CLAUDE_WORKER_CONCURRENCY¶
Type: Integer (1-3)
Default: 1
Description: Max concurrent Claude workers
OpenAI Configuration¶
OPENAI_API_KEY¶
Type: String Default: (none) Description: OpenAI API key for legacy features
OPENAI_MODEL¶
Type: String
Default: gpt-5-codex-latest
Description: OpenAI model for API backend
OPENAI_MAX_RETRIES¶
Type: Integer
Default: 3
Description: Retry count for OpenAI API calls
Backend Selection¶
FORCE_BACKEND¶
Type: String (stub, codex, api)
Default: (auto-select)
Description: Force specific planner backend
Auto-selection priority: 1. Codex CLI (if installed) 2. OpenAI API (if key set) 3. Stub (fallback)
Automation Level¶
AUTOMATION_LEVEL¶
Type: String (interactive, medium, yolo)
Default: interactive
Description: Automation mode for planning
Levels:
- interactive: Require approval for code/git changes
- medium: Auto-run tests, require approval for commits
- yolo: Full automation (use with caution)
Example Configurations¶
Fast Local Development¶
export KB_EMBEDDING_MODEL="sentence-transformers/all-MiniLM-L6-v2"
export CLAUDE_USE_SDK="1"
export AUTOMATION_LEVEL="interactive"
Production Quality¶
export KB_EMBEDDING_MODEL="sentence-transformers/all-mpnet-base-v2"
export CLAUDE_USE_SDK="1"
export CLAUDE_WORKER_CONCURRENCY="3"
export AUTOMATION_LEVEL="medium"