Configuration

export CLI_API_TOKEN="your-secret-token"

# Default
HAPI_API_URL="http://localhost:3006"

# Remote hub
HAPI_API_URL="https://hapi.example.com"

# Default
HAPI_HOME="~/.hapi"

# Custom location
HAPI_HOME="/opt/hapi-data"

# Enable
export HAPI_EXPERIMENTAL="true"  # or "1" or "yes"

# Disable (default)
unset HAPI_EXPERIMENTAL

# Use custom Claude installation
export HAPI_CLAUDE_PATH="/opt/claude/bin/claude"

# Use specific version
export HAPI_CLAUDE_PATH="/usr/local/bin/claude-v2"

# Set default MCP server
export HAPI_HTTP_MCP_URL="http://localhost:8080"

# Use with hapi mcp (uses default URL)
hapi mcp

# Override with command line
hapi mcp --url http://localhost:9000

# Default: 60000 (60 seconds)
export HAPI_RUNNER_HEARTBEAT_INTERVAL=60000

# More frequent (30 seconds)
export HAPI_RUNNER_HEARTBEAT_INTERVAL=30000

# Less frequent (2 minutes)
export HAPI_RUNNER_HEARTBEAT_INTERVAL=120000

# Default: 10000 (10 seconds)
export HAPI_RUNNER_HTTP_TIMEOUT=10000

# Increase for slow connections
export HAPI_RUNNER_HTTP_TIMEOUT=30000

# Set automatically by runner
HAPI_WORKTREE_BASE_PATH="/Users/you/projects/my-repo"

# Set automatically by runner
HAPI_WORKTREE_BRANCH="hapi-feature-auth"

# Set automatically by runner
HAPI_WORKTREE_NAME="feature-auth"

# Set automatically by runner
HAPI_WORKTREE_PATH="/Users/you/projects/my-repo-worktrees/feature-auth"

# Set automatically by runner
HAPI_WORKTREE_CREATED_AT="1703001234567"

# Auto-generated on first run if not set
CLI_API_TOKEN="auto-generated-token-123"

# Manually set
CLI_API_TOKEN="my-secure-token"

# Get from https://t.me/BotFather
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

# Default: true (if TELEGRAM_BOT_TOKEN is set)
TELEGRAM_NOTIFICATION="true"

# Disable notifications
TELEGRAM_NOTIFICATION="false"

# Default: localhost only
HAPI_LISTEN_HOST="127.0.0.1"

# Listen on all interfaces
HAPI_LISTEN_HOST="0.0.0.0"

# Specific interface
HAPI_LISTEN_HOST="192.168.1.100"

# Default
HAPI_LISTEN_PORT="3006"

# Custom port
HAPI_LISTEN_PORT="8080"

# Production
export HAPI_PUBLIC_URL="https://hapi.example.com"

# Cloudflare Tunnel
export HAPI_PUBLIC_URL="https://hapi.your-tunnel.trycloudflare.com"

# Tailscale
export HAPI_PUBLIC_URL="https://hapi.your-tailnet.ts.net"

# Allow all (not recommended for production)
CORS_ORIGINS="*"

# Specific origins
CORS_ORIGINS="https://app.example.com,https://admin.example.com"

# Derive from HAPI_PUBLIC_URL (automatic if not set)
# No manual configuration needed

# Default
HAPI_HOME="~/.hapi"

# Custom location
HAPI_HOME="/var/lib/hapi"

# Default: $HAPI_HOME/hapi.db
DB_PATH="~/.hapi/hapi.db"

# Custom location
DB_PATH="/data/hapi/database.db"

# Default
HAPI_RELAY_API="relay.hapi.run"

# Custom relay
HAPI_RELAY_API="relay.your-domain.com"

# Default
HAPI_RELAY_AUTH="hapi"

# Custom key
HAPI_RELAY_AUTH="your-secret-key"

# Enable
HAPI_RELAY_FORCE_TCP="true"  # or "1"

# Disable (default)
unset HAPI_RELAY_FORCE_TCP

# Default
VAPID_SUBJECT="mailto:[email protected]"

# Custom
VAPID_SUBJECT="mailto:[email protected]"
VAPID_SUBJECT="https://your-website.com"

export ELEVENLABS_API_KEY="your-api-key"

# Auto-created if not set
export ELEVENLABS_AGENT_ID="agent-id-123"

{
  "machineId": "machine-uuid-123",
  "cliApiToken": "your-secret-token:namespace",
  "onboardingCompleted": true,
  "lastUsed": 1703001234567
}

{
  "telegramBotToken": "123456789:ABC...",
  "telegramNotification": true,
  "listenHost": "127.0.0.1",
  "listenPort": 3006,
  "publicUrl": "https://hapi.example.com",
  "corsOrigins": ["https://app.example.com"],
  "cliApiToken": "auto-generated-token-123"
}