.env.example

# Required. Set a real key with sessions:create and sessions:transcript:read.
HICHARLIE_API_KEY=
HICHARLIE_BASE_URL=https://voice.hicharlie.fr
# Optional. Use only when the target HiCharlie agent restricts widget origins.
# HICHARLIE_SESSION_ORIGIN=https://example-hotel.com
# Optional override for local WebRTC widget loading. Defaults to HICHARLIE_BASE_URL/widget.js.
# HICHARLIE_WIDGET_SCRIPT_URL=https://voice.hicharlie.fr/widget.js
VOICECODE_QUEUE_ENABLED=1
VOICECODE_QUEUE_BACKEND=local
VOICECODE_QUEUE_HEARTBEAT_SECONDS=2
VOICECODE_QUEUE_STALE_SECONDS=6
VOICECODE_QUEUE_POLL_SECONDS=0.25
# VOICECODE_QUEUE_DB_PATH=~/Library/Caches/voicecode-mcp/queue.sqlite3
# Use the shared localhost UI by default. Set to 0 for direct WebRTC calls without UI.
VOICECODE_LOCAL_UI_ENABLED=1
# Set to 0 when the shared UI should list rooms without opening a new browser tab per call.
VOICECODE_LOCAL_UI_AUTO_OPEN=1
# manual = click to open the next queued room; auto_chain = open it automatically.
VOICECODE_CALL_HANDOFF_MODE=manual
# Optional override for persisted UI settings.
# VOICECODE_LOCAL_UI_CONFIG_PATH=~/Library/Caches/voicecode-mcp/local_ui_config.json
VOICECODE_TRANSCRIPT_STORE_ENABLED=1
# VOICECODE_TRANSCRIPT_DB_PATH=~/Library/Caches/voicecode-mcp/transcripts.sqlite3
VOICECODE_COMPLETION_INBOX_ENABLED=1
# VOICECODE_COMPLETION_INBOX_DB_PATH=~/Library/Caches/voicecode-mcp/completions.sqlite3
# Optional stable id for this MCP client/machine. Generated locally when unset.
# VOICECODE_CLIENT_INSTANCE_ID=voicecode-dev-machine
VOICECODE_DELIVERY_ENABLED=1
VOICECODE_DELIVERY_AUTO_DISPATCH=1
VOICECODE_DELIVERY_RETRY_SECONDS=30
VOICECODE_DELIVERY_MAX_ATTEMPTS=5
VOICECODE_DELIVERY_STALE_SECONDS=600
# Optional. Defaults to `codex` from PATH.
# VOICECODE_CODEX_BIN=/Applications/Codex.app/Contents/Resources/codex
# Optional explicit fallback when CODEX_THREAD_ID is not provided by the MCP host.
# VOICECODE_CODEX_THREAD_ID=019e...
# Experimental local Visual Surface Runtime.
VOICECODE_VISUAL_RUNTIME_PORT=8798
# VOICECODE_VISUAL_RUNTIME_DB_PATH=~/Library/Caches/voicecode-mcp/visual-runtime.sqlite3