Environment Variables Inventory¶
Updated: 2026-03-30
Core Runtime Variables¶
| Variable | Default | Purpose |
|---|---|---|
AMPLIHACK_HOME | auto-detected | Root of amplihack installation |
AMPLIHACK_AGENT_BINARY | set by launcher | Which agent CLI to use (claude/copilot) |
AMPLIHACK_SESSION_DEPTH | 0 | Current nesting depth for nested agent sessions |
AMPLIHACK_TREE_ID | auto-generated | Unique ID for the current recipe execution tree |
AMPLIHACK_MAX_DEPTH | 3 | Maximum recursion depth for nested recipes |
AMPLIHACK_MAX_SESSIONS | 10 | Maximum concurrent sessions per tree |
AMPLIHACK_NONINTERACTIVE | unset | Set to 1 to skip interactive prompts |
AMPLIHACK_DEBUG | unset | Set to true for verbose debug output |
AMPLIHACK_GRAPH_DB_PATH | ~/.amplihack/graph.db | Path to Kuzu graph database |
AMPLIHACK_CONTEXT_FILE | unset | Path to JSON context file (set by runner for large contexts) |
AMPLIHACK_RECIPE_LOG | unset | Path to recipe execution log file |
Recipe Runner Variables¶
| Variable | Default | Purpose |
|---|---|---|
RECIPE_RUNNER_RS_PATH | PATH search | Override path to recipe-runner-rs binary |
RECIPE_RUNNER_INSTALL_TIMEOUT | 300 | Timeout in seconds for cargo install |
RECIPE_VAR_* | from context | Context variables passed to bash steps as env vars |
Azure / Cloud Variables¶
| Variable | Default | Purpose |
|---|---|---|
AZURE_SUBSCRIPTION_ID | unset | Azure subscription for fleet operations |
AZURE_TENANT_ID | unset | Azure tenant ID |
AZURE_CLIENT_ID | unset | Azure service principal client ID |
AZURE_CLIENT_SECRET | unset | Azure service principal secret |
Agent / LLM Variables¶
| Variable | Default | Purpose |
|---|---|---|
ANTHROPIC_API_KEY | unset | API key for Claude models |
OPENAI_API_KEY | unset | API key for OpenAI models |
CLAUDECODE | set by Claude Code | Removed by recipe runner to allow nested sessions |