Config keys and environment variables
Profile keys
Section titled “Profile keys”Set with kcap config set <key> <value>; the full table with defaults and meanings is in Configuration. Stored but managed by their own commands: allowed_paths and excluded_paths (allow, ignore), cwd_remap (remap), remote patterns (profile add --remote), update_channel (update --beta|--stable), import_org (import --org)
Environment variables
Section titled “Environment variables”| Variable | Effect |
|---|---|
KCAP_URL | Server URL for this process; beats every profile source except --server-url |
KCAP_PROFILE | Profile to use; beats .kcap.json, remote patterns and bindings |
KCAP_CONFIG_DIR | Replaces ~/.config/kcap |
KCAP_LOCAL_ROOT | Replaces ~/.config/kcap/local |
KCAP_SESSION_ID | Set by the session-start hook; names the current session for recap, errors, set-title, page publish |
KCAP_CLIENT_ID, KCAP_CLIENT_SECRET | Authenticate as a machine instead of your login |
KCAP_DAEMON_NAME, KCAP_MAX_AGENTS, KCAP_DAEMON_LOG_LEVEL | Daemon name, agent limit (beats the flag) and log level |
KCAP_CLAUDE_PATH, KCAP_CODEX_PATH, KCAP_CURSOR_PATH, KCAP_COPILOT_PATH, KCAP_GEMINI_PATH, KCAP_KIRO_PATH, KCAP_OPENCODE_PATH, KCAP_ANTIGRAVITY_PATH, KCAP_PI_PATH, KCAP_MUSE_PATH, KCAP_GROK_PATH | The daemon’s path to each vendor’s binary |
KCAP_PI_MODEL | Model for the unattended Pi reviewer |
KCAP_KIRO_UNATTENDED_REVIEWER, KCAP_GEMINI_UNATTENDED_REVIEWER, KCAP_ANTIGRAVITY_UNATTENDED_REVIEWER, KCAP_OPENCODE_UNATTENDED_REVIEWER, KCAP_PI_UNATTENDED_REVIEWER, KCAP_GROK_UNATTENDED_REVIEWER, KCAP_MUSE_UNATTENDED_REVIEWER | 0 disables that vendor as an unattended reviewer on this daemon |
KCAP_USE_PROVIDER_API_KEY | 1 keeps ANTHROPIC_API_KEY/OPENAI_API_KEY in headless spawns; beats the profile |
KCAP_TELEMETRY, DO_NOT_TRACK | KCAP_TELEMETRY=0 or DO_NOT_TRACK=1 turns CLI telemetry off; KCAP_TELEMETRY wins |
KCAP_SQLITE_NATIVE_BASE_URL | Mirror for the SQLite library OpenCode imports fetch |
KCAP_SETUP_ARGS | Options for kcap setup when using the Windows install script |
KIROCREW_HOME | Where Kiro Crew lives, if not ~/.kiro/crew |
CLAUDE_CONFIG_DIR, CODEX_HOME, GEMINI_CLI_HOME, OPENCODE_CONFIG_DIR, PI_CODING_AGENT_DIR, COPILOT_HOME, KIRO_HOME, GROK_HOME, VIBE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME | The agents’ own config locations, which kcap follows for detection, install and import |
A daemon service captures its environment at install; reinstall it after changing any of these