Environment Variables¶
Every SUPERQODE_* variable in one place. Most behavior is configurable per-harness or in superqode.yaml too; env vars win for quick experiments, CI, and per-shell overrides.
Agent loop¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_AUTO_COMPACT | 0/1 | on | Adaptive context compaction (prune stale tool output first, summarize only if still needed). |
SUPERQODE_DOOM_LOOP_THRESHOLD | int | 3 | Consecutive identical tool calls before the guard intercepts; 0 disables. |
SUPERQODE_RATE_LIMIT_RETRIES | int | 3 | Retries with backoff on 429/503/529/overloaded (honors Retry-After). |
SUPERQODE_REMINDERS | 0/1 | on | <system-reminder> notes: externally-changed files, stale todos. |
SUPERQODE_AUTO_MEMORY | 0/1 | off | Extract durable preferences/facts/decisions after completed runs into local memory (background task, deduplicated, tagged auto). |
SUPERQODE_AUTO_RECALL | 0/1 | off | Surface relevant saved memories to the agent at run start, as a clearly labeled system reminder (local provider only, once per prompt). |
Tools¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_TOOL_PROFILE | coding/full/standard/ds4/none | coding | Which tool registry interactive sessions use. |
SUPERQODE_DEFERRED_TOOLS | auto/all/names | off | Hide heavy tool schemas until the model activates them via tool_search. auto = local providers only. |
SUPERQODE_TOOL_OUTPUT_DIR | path | ~/.superqode/tool-output | Where oversized tool output spills (7-day retention). |
SUPERQODE_VERIFY_EDITS | 0/1 | on | Post-edit diagnostics (ruff/py_compile, eslint, gofmt, JSON/YAML) fed back to the model. |
SUPERQODE_FORMAT_ON_EDIT | 0/1 | off | Auto-format files after agent edits. |
SUPERQODE_SEARCH_ROOTS | paths (:-sep) | unset | Extra read-only roots for read/search tools (cloned repos outside the project). |
SUPERQODE_ALLOW_EXTERNAL_SEARCH | 0/1 | off | Permission-gate for absolute search paths outside the workspace. |
SUPERQODE_RLM_TOOLS | 0/1/true/on | off | Add governed host functions to the standalone Monty python_repl tool; does not modify the resident RLM research kernel. |
SUPERQODE_MCP_SEARCH | 0/1 | off | Inject MCP search/execute tools into the registry. |
SUPERQODE_TOOL_DISCOVERY | 0/1/legacy/shadow/unified | per harness | Enable portable progressive discovery or select its rollout mode. |
SUPERQODE_TOOL_DISCOVERY_MODE | legacy/shadow/unified | per harness | Override the configured discovery mode. |
SUPERQODE_TOOL_SEARCH_BACKEND | bm25/lexical/configured backend | per harness | Override the configured retrieval backend. |
SUPERQODE_TOOL_DISCOVERY_TRACE_DIR | path | unset | Write sanitized progressive-discovery traces below tool-discovery/. |
Safety & policy¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_EXEC_POLICY | path | unset | Explicit exec-policy YAML, prepended to project (.superqode/execpolicy.yaml) and user (~/.superqode/execpolicy.yaml) rules. |
SUPERQODE_SHELL_ENV_POLICY | inherit/filter-secrets | inherit | Strip secret-looking env vars (*KEY*, *TOKEN*, *SECRET*, *PASSWORD*, ...) from spawned shell commands. |
SUPERQODE_SHELL_ENV_ALLOW | names (,-sep) | unset | Exceptions kept when filtering secrets. |
SUPERQODE_SANDBOX | mode | off | OS sandbox for shell commands (macOS Seatbelt / Linux bwrap). |
SUPERQODE_ORG_POLICY | path | unset | Load the organization-level contextual policy applied before project and harness policy. |
SUPERQODE_NET_STRICT | 0/1 | off | Restrict network tools to the configured destination allowlist. |
SUPERQODE_NET_ALLOW | domains (,-sep) | unset | Add domains to the default network destination allowlist. |
TYPESAFE_API_KEY | secret | unset | Credential for live Jev decisions, tool checks, and rubric grading. Set it in the launching process; coding-provider credentials remain separate. |
SUPERQODE_RUBRIC_GRADER | systemone | unset | Opt in to Jev rubric verdicts for --rubric; uncertainty remains ungraded. Unset uses the utility model. |
SUPERQODE_SYSTEMONE | 0/stub/replay/live | unset | Opt-in System One tool gate. Unset leaves the gate off. stub/replay/live enable it; 0 forces it off. live skips when no API key is set. |
SUPERQODE_SYSTEMONE_MODE | enforce/shadow | per harness | Override whether Jev tool-gate decisions enforce or only observe policy. |
SUPERQODE_SYSTEMONE_TOOL_SEARCH | off/shadow/rerank | per harness | Override Jev's role in deferred tool selection. |
SUPERQODE_SYSTEMONE_TRACE_DIR | path | unset | Write sanitized System One decision and tool-search traces. |
SUPERQODE_TOOL_ROUTING | off/shadow/enforce | off | Ask Jev once per native SuperQode turn which tool schemas are needed. Shadow records the decision; enforce sends only the selected schemas. Missing credentials and decision failures keep the full list. |
SUPERQODE_TOOL_ROUTING_THRESHOLD | float from 0 to 1 | 0.30 | Minimum Jev Noul probability for a non-core tool to remain visible. |
SUPERQODE_TOOL_ROUTING_TIMEOUT_MS | positive integer | 1500 | Deadline for the once-per-turn Jev routing decision. |
SUPERQODE_TOOL_ROUTING_ALWAYS_KEEP | names (,-sep) | unset | Add tool names to the built-in workspace-tool safety floor. |
SUPERQODE_CONDITIONAL_INSTRUCTIONS | 1/on | unset | Reload <!-- sq:when --> sections from AGENTS.md into the pinned system prompt when a path, tool, or task matches. Unset keeps every instruction file in the prompt as written. |
SUPERQODE_CONTEXT_MODE | off/shadow/enforce | off | Prepare shared hosted context projections before model calls. Shadow records proposed excerpts; enforce applies them with durable retrieval references. Harness runtime.config.context.mode takes precedence. |
SUPERQODE_CONTEXT_SELECTOR | rules/jev | rules | Use local old-output selection or optional bounded System One scoring; the coding model stays fixed. Harness context configuration takes precedence. |
SUPERQODE_CONTEXT_STORE | path | ~/.superqode/context/artifacts.sqlite3 | Host-owned SQLite evidence store for scoped references, bounded pages and restart recovery. Keep it outside task worktrees. |
SUPERQODE_JEV_CONTEXT | off/shadow/enforce | off | At the compaction boundary, ask Jev whether old tool outputs are still needed. Unset leaves compaction on the existing prune-then-summary path. shadow records the decision and leaves the prompt unchanged. enforce stubs an output only when Jev is confidently finished with it, the cut is at least 25%, and the result fits the window. |
SUPERQODE_JEV_CONTEXT_CLIENT | stub/replay/live | stub, or the active SUPERQODE_SYSTEMONE client | Decision client for context prune. live requires TYPESAFE_API_KEY and does not by itself enable the tool gate. |
SUPERQODE_JEV_CONTEXT_TIMEOUT_MS | positive integer | System One timeout, else 5000 | Deadline for one context-prune decision. A timeout leaves the prompt unchanged. |
SUPERQODE_GATEWAY_UPSTREAM | absolute HTTP(S) URL | unset | Default upstream for superqode serve optimize; equivalent to --upstream. |
Providers & models¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_PROVIDER | provider id | openai | Default provider for headless runs. |
SUPERQODE_MODEL | model id | <openai-fast-model> | Default model for headless runs. |
SUPERQODE_UHP_BASE_URL | URL | unset | Unified Harness Protocol server root used by superqode connect uhp and the registered uhp harness route. |
SUPERQODE_UHP_API_KEY | bearer token | unset | Credential for that UHP server. A key set here is never copied into the saved connection file. |
SUPERQODE_UHP_HARNESS | harness id | unset | Harness on the UHP server to select. |
SUPERQODE_UHP_MAX_OUTPUT_TOKENS | int | unset | Cap the token budget for one UHP task. Useful where a provider checks affordability against the reserved budget rather than usage. |
SUPERQODE_A2A_TOKEN | bearer token | unset | Operator token for superqode serve a2a, and a fallback client token for superqode connect a2a. |
SUPERQODE_A2A_URL | URL | unset | A2A agent origin used by superqode connect a2a. |
SUPERQODE_A2A_CLIENT_TOKEN | bearer token | unset | Bearer for superqode connect a2a. A value set here is never copied into the saved connection file. |
SUPERQODE_A2A_KEY | bearer token | unset | Example key variable name in the optional RLM A2A setup screen. It is used only when a peer's credential_env names it. Other variable names are supported; setting a key never enables routing or paid fallback. |
SUPERQODE_API_KEY | bearer token | unset | SuperQode API key for a real model chat. Accepted as the A2A client Bearer when SUPERQODE_A2A_CLIENT_TOKEN / SUPERQODE_A2A_TOKEN are unset. Get one at https://superqode.dev. |
SUPERQODE_A2A_OAUTH_CLIENT_ID | OAuth client id | unset | Public client id for A2A OAuth. Must be registered with redirect URI http://localhost:19876/a2a/oauth/callback. Required unless the authorization server advertises registration_endpoint. |
SUPERQODE_A2A_OAUTH_CLIENT_SECRET | OAuth client secret | unset | Confidential-client secret. Enables the client-credentials grant and token-endpoint authentication. |
SUPERQODE_A2A_TLS_CERT | path | unset | Client certificate PEM for connect a2a mutual TLS. A value set here is never copied into the saved connection file. |
SUPERQODE_A2A_TLS_KEY | path | unset | Private key PEM that pairs with SUPERQODE_A2A_TLS_CERT. |
SUPERQODE_A2A_KEY_SECRET | secret | unset | Signs and verifies customer API keys. Without it the server rejects every key. Generate with superqode a2a-keys secret. |
SUPERQODE_A2A_REVOKED_KEYS | comma-separated ids | unset | Key ids refused before their expiry. |
SUPERQODE_A2A_ALLOWED_ORIGINS | comma-separated hosts | unset | When set, connect a2a refuses Agent Card origins that are not on this list. --allow-origin adds entries for one invocation. |
SUPERQODE_A2A_JWS_TRUST_ROOT | path | unset | PEM or JWKS file used to root an Agent Card JWS. A signature without a trust root is not identity and is not authentication. |
SUPERQODE_HARNESS | path | unset | HarnessSpec YAML/JSON to load on start. |
SUPERQODE_PIPY_DIR | path | ~/.superqode/pipy | Root for everything the PiPy harness writes. |
SUPERQODE_PIPY_SESSION_DIR | path | <pipy dir>/sessions | Where PiPy stores its session tree, one directory per working directory. |
SUPERQODE_RLM_DIR | path | ~/.superqode/rlm | Root for native RLM sessions and runtime state. |
SUPERQODE_RLM_SESSION_DIR | path | <rlm dir>/sessions | Where the native RLM harness stores its session trees. |
SUPERQODE_PURE_PERMISSIONS_HEADLESS | 1 to allow | unset | Allow a harness with no approvals or sandbox, such as PiPy, to run headless. Unattended runs have no reviewer, so this must be set deliberately. |
SUPERQODE_CONNECT | profile name | unset | Auto-connect a connection profile when the TUI starts (set by --connect). |
SUPERQODE_CONNECT_MENU | v1/v2 | v1 | Connect existing-harness layout. v1 keeps Other harnesses; v2 shows Open (and Closed once that list is non-empty). Overrides connect_menu in ~/.superqode/config.json. |
SUPERQODE_STDIN_WAIT | seconds | 0.2 | How long a headless run waits for piped stdin before deciding none was sent. |
SUPERQODE_RUNTIME | runtime id | builtin | Select the default runtime adapter when no CLI or project runtime is set. |
SUPERQODE_COPILOT_TIMEOUT | seconds | 600 | Maximum wait for one GitHub Copilot SDK prompt turn. |
SUPERQODE_COPILOT_STARTUP_TIMEOUT | seconds | 60 | Maximum wait for GitHub Copilot SDK runtime and session startup. |
SUPERQODE_VENDOR_CLI_TIMEOUT | seconds | 900 | Maximum wait for one turn from a vendor CLI subscription runtime. |
SUPERQODE_COPILOT_AUTH_PROBE_TIMEOUT | seconds | 15 | Maximum wait for the background check of whether the Copilot CLI is signed in. |
SUPERQODE_CODEX_PREFER_LOCAL_CLI | 0/1 | on | Prefer a compatible installed Codex CLI app-server over the SDK-pinned server. |
SUPERQODE_CODEX_BIN | executable path or name | codex on PATH | Select the executable for the native Codex CLI runtime. An invalid explicit selection reports an error. |
SUPERQODE_CODEX_SERVER | loopback WebSocket URL | unset | Attach the native Codex runtime to a user-owned local app-server, such as ws://127.0.0.1:4500. Its version must match the selected CLI. Unset launches a private stdio app-server. |
SUPERQODE_ANTIGRAVITY_CLI_AGENT | custom agent name | CLI default | Pass a custom agent to signed-in agy --agent. |
SUPERQODE_ANTIGRAVITY_CLI_EFFORT | low/medium/high | CLI default | Pass a thinking level to agy --effort; requires agy 1.1.5 or newer. |
SUPERQODE_ANTIGRAVITY_SKILLS | paths (:-sep) | unset | Add skill directories to the local Antigravity SDK runtime. |
SUPERQODE_ANTIGRAVITY_AGENT | agent id | antigravity-preview-05-2026 | Override the Google-hosted Antigravity managed agent ID. |
SUPERQODE_ANTIGRAVITY_MODEL | model id | agent default | Choose a model supported by the managed Antigravity agent. |
SUPERQODE_ANTIGRAVITY_MAX_TOTAL_TOKENS | int | unset | Cap input, output, and thinking tokens for each managed Antigravity interaction. |
SUPERQODE_DEVIN_CLI_PERMISSION_MODE | Devin permission mode | bypass | Mode for devin --print turns. Anything other than bypass can stall an unattended turn on an approval prompt. |
SUPERQODE_DEVIN_CLI_SANDBOX | 0/1 | on where supported | Disable devin --sandbox. Setting 1 never forces it onto a platform Devin cannot sandbox. |
OLLAMA_HOST etc. | URL | per-provider | Local server endpoints (see Local Models). |
Provider API keys (OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, ...) follow each provider's standard names. See BYOK Providers.
Local model tuning¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_OLLAMA_NUM_CTX | int | unset | Request this context length from Ollama per call. Ollama's MLX backend honors only Modelfile-baked values. |
SUPERQODE_OLLAMA_KEEP_ALIVE | duration | unset | Optional override for Ollama model residency. When unset, the server's keep-alive policy applies. Set 0 to unload after each response. |
SUPERQODE_CAPABILITY_TIMEOUT | seconds | 2 | Maximum wait when asking a local runtime what a model supports (for example Ollama's capability list). On timeout the model is treated as tool-capable rather than silently downgraded. |
SUPERQODE_DISABLE_LOCAL_SHAPING | 0/1 | off | Skip local-request shaping (num_ctx, keep-alive, tool-temperature clamps). |
SUPERQODE_DISABLE_PROMPT_CACHE | 0/1 | off | Disable prompt-cache annotations on outgoing requests. |
SUPERQODE_DS4_THINKING | mode | unset | Force the DS4 thinking mode instead of the per-model default. |
SUPERQODE_DS4_TOOL_MODE | always/auto/never | always | Control whether DS4 requests include tools. never also accepts off/false/0. |
SUPERQODE_DS4_WARMUP | 0/1 | off | Opt into a DS4 warmup request after connecting. Preloading can consume substantial RAM and power. |
SUPERQODE_LOCAL_WARMUP | 0/1 | off | Opt into a warmup request after connecting to a local model. Default setup checks omit warmup generation. Starting a model server can still load weights; DS4 has a separate setting. |
SUPERQODE_LOCAL_WARMUP_TIMEOUT | seconds | 45 | Maximum wait for automatic local-model warmup. |
SUPERQODE_LAGUNA_GGUF | absolute path | unset | Pin the Laguna S 2.1 GGUF file instead of using automatic cache discovery. |
SUPERQODE_MLX_INPROCESS | 0/1 | on | Serve MLX models in-process; set 0 to require an external server. |
SUPERQODE_UTILITY_PROVIDER | apple-fm or provider/model | unset | Route utility calls (rubric grading, memory extraction) to a cheaper model; apple-fm uses the on-device Apple Foundation Model. Falls back to the session model. See Local Stack Doctor. |
Channel daemon¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_TELEGRAM_BOT_TOKEN | token | unset | Telegram bot token for superqode daemon (from @BotFather). |
SUPERQODE_SLACK_APP_TOKEN | xapp-... | unset | Slack app-level token for Socket Mode. |
SUPERQODE_SLACK_BOT_TOKEN | xoxb-... | unset | Slack bot token for posting messages. |
SUPERQODE_DISCORD_BOT_TOKEN | token | unset | Discord bot token for the Gateway connection. |
Chat allowlists and defaults live in ~/.superqode/channels.yaml. See Chat Channels.
Observability¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_OBS_OTEL_ENABLED | 0/1 | off | Enable the OpenTelemetry harness-event sink. |
SUPERQODE_OBS_MLFLOW_ENABLED | 0/1 | off | Enable the MLflow artifact sink. |
SUPERQODE_OBS_MLFLOW_EXPERIMENT | name | superqode-harness | Select the MLflow experiment used for harness traces. |
SUPERQODE_OBS_LANGSMITH_ENABLED | 0/1 | off | Enable the LangSmith harness-event sink. |
SUPERQODE_OBS_LOGFIRE_ENABLED | 0/1 | off | Enable the Logfire harness-event sink. |
SUPERQODE_OBS_ARIZE_ENABLED | 0/1 | off | Enable the Arize Phoenix harness-event sink. |
Exporter endpoints, project names, service names, and credentials use the exporter's standard environment variables or the HarnessSpec observability configuration. See Harness System.
ACP connections¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_ACP_CLIENT | client id | unset | Pin which ACP client implementation the TUI uses. |
SUPERQODE_ACP_STARTUP_TIMEOUT | seconds | 15 | How long to wait for an ACP agent process to start. |
SUPERQODE_ACP_REQUEST_TIMEOUT | seconds | 12 | Timeout for individual ACP requests. |
SUPERQODE_ACP_PROMPT_TIMEOUT | seconds | 180 | Timeout for a full ACP prompt turn. |
SUPERQODE_ACP_TERMINAL_PTY | 0/1 | on | Allocate a PTY for ACP terminal sessions (POSIX only). |
SUPERQODE_ACP_TRAFFIC_LOG | 0/1 | off | Record raw ACP JSON-RPC traffic for debugging. |
SUPERQODE_ACP_TRAFFIC_LOG_PATH | path | under SUPERQODE_HOME | Where the ACP traffic log is written. |
SUPERQODE_ACP_PRINT_LOGS | 0/1 | off | Print agent process logs through the TUI (opencode agents). |
SUPERQODE_FAST_AGENT_ACP_COMMAND | command | built-in | Override the command used to launch the fast-agent ACP server. |
SUPERQODE_ACP_SPEC | path or template:<name> | discovered per session | Pin the HarnessSpec exposed by superqode serve acp. |
SUPERQODE_ACP_PROVIDER | provider id | HarnessSpec route | Override the provider used by the SuperQode ACP server. |
SUPERQODE_ACP_MODEL | model id | HarnessSpec route | Override the model used by the SuperQode ACP server. |
MCP harness server¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_MCP_PROVIDER | provider id | HarnessSpec route | Override the provider used by the harness MCP server. |
SUPERQODE_MCP_MODEL | model id | HarnessSpec route | Override the model used by the harness MCP server. |
Jev Tool Routing¶
The Jev Tool Routing guide explains how these variables apply to native routing, external harness launchers, the Python SDK, HTTP, and MCP.
| Variable | Values | Default | Effect |
|---|---|---|---|
TYPESAFE_API_KEY | secret | unset | TypeSafe credential used by local routing, the HTTP service, and routing MCP server. |
OPENAI_API_KEY | secret | unset | OpenAI upstream credential for an API-key-backed optimized run. |
ANTHROPIC_API_KEY | secret | unset | Anthropic upstream credential, including Claude Code gateway runs. |
GEMINI_API_KEY | secret | unset | Google upstream credential for native Gemini runs from OpenCode or Pi. It is never written into generated harness configuration. |
XAI_API_KEY | secret | unset | xAI upstream credential for Grok Build gateway runs. |
SUPERQODE_JEV_SERVICE_TOKEN | secret | unset | Bearer token required by serve jev on a non-loopback bind. Protects every endpoint except /healthz. |
SUPERQODE_TOOL_ROUTING | off/shadow/enforce | off | Native-loop Jev Tool Routing mode. |
SUPERQODE_TOOL_ROUTING_THRESHOLD | 0.0-1.0 | 0.30 | Minimum keep probability for native-loop routing. |
SUPERQODE_TOOL_ROUTING_TIMEOUT_MS | integer | 1500 | Jev decision deadline for native-loop routing. |
SUPERQODE_TOOL_ROUTING_ALWAYS_KEEP | comma/space-separated names | core workspace tools | Add tools to the native routing safety floor. |
SUPERQODE_BIN_DIR | directory | ~/.local/bin | Destination for managed *-jev launchers created by superqode optimize enable. |
SUPERQODE_HOME | directory | ~/.superqode | Parent for the non-secret jev-routing.json launcher preferences. |
PORT | integer | 8080 | Port used by superqode serve jev, including Cloud Run. |
Core, sessions, and state¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_HOME | path | ~/.superqode | Root for user-level SuperQode state (trust store, logs, tool output). |
SUPERQODE_STATE_DIR | path | .superqode | Project-level state directory used by workspace coordination. |
SUPERQODE_TRUST_STORE | path | ~/.superqode/trust.json | Location of the project trust store. |
SUPERQODE_CWD | path | set automatically | Project root propagated to spawned helper processes. |
SUPERQODE_MAX_ITERATIONS | int | 0 (unlimited) | Safety cap on agent loop iterations per run. |
SUPERQODE_SESSION_HISTORY_LIMIT | int | 20 | How many stored messages a resumed session loads. |
SUPERQODE_PROGRESS_DIR | path | ~/.superqode | Where :tour and :explore milestones are stored. Point it elsewhere so automation does not rewrite a developer's own progress. |
SUPERQODE_STARTUP_HEALTH | 0/1 | off | Run provider health checks at TUI startup. |
Output & UX¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_LOG_VERBOSITY | quiet/normal/verbose | normal | Tool-output verbosity. Set by --quiet/--verbose; the TUI :log command changes it live. |
SUPERQODE_QUIET | 0/1 | off | Same as passing --quiet. |
SUPERQODE_VERBOSE | 0/1 | off | Same as passing --verbose. |
SUPERQODE_VIM_MODE | 0/1 | saved preference or off | Override the optional Vim-like modal navigation layer for the TUI. |
SUPERQODE_NO_BROWSER | 0/1 | off | Do not open the system browser automatically during subscription login. Print the login URL instead. |
SUPERQODE_NO_SPLASH | 0/1 | off | Skip the wordmark printed while the TUI starts. The splash covers the wait before the first frame and is already suppressed when output is not a terminal. |
Terminal appearance¶
| Variable | Values | Default | Effect |
|---|---|---|---|
SUPERQODE_TERMINAL_BACKGROUND | #rrggbb | terminal reply or appearance fallback | Set the initial system-theme canvas where OSC reporting is unavailable. |
SUPERQODE_TERMINAL_FOREGROUND | #rrggbb | terminal reply or appearance fallback | Set the initial system-theme text color. |
COLORFGBG | terminal color indices separated by semicolons | unset | Appearance fallback; background index 7 or 15 selects light. |
See Themes for system detection and named light/dark pairs.
Environment notes¶
- Boolean variables accept
1/true/yes/onand0/false/no/off. - Env vars set in the shell that launches SuperQode are inherited by spawned subprocesses (ACP clients, shell sessions) unless the env policy filters them.
- The Agent Loop guide explains the behavior behind each loop variable.
Local diagnostic logging¶
| Variable | Meaning |
|---|---|
SUPERQODE_DEBUG | Set to 1 by --debug after private diagnostic logging is configured. |
SUPERQODE_LOG_FILE | The log path selected by --log-file or the local debug default. |
Use the CLI options to configure the logger. Setting these reporting variables alone does not open a log file or enable provider SDK request dumps.