269 config keys across 22 categories. All read from scorpiox-env.txt โ a flat key=value file. No YAML, no TOML, no JSON config. Pure simplicity, parsed in C.
scorpiox code reads configuration from scorpiox-env.txt โ a flat key=value file with no nesting, no quoting, and no special syntax. Files are checked in priority order: project-level overrides user-level, which overrides exe-level. OS environment variables take highest priority.
<exe_dir>/scorpiox-env.txt
~/.scorpiox/scorpiox-env.txt
./.scorpiox/scorpiox-env.txt
# scorpiox-env.txt โ flat key=value, no nesting, no quoting required PROVIDER=anthropic ANTHROPIC_API_KEY=sk-ant-... MODEL=sonnet THINKING=1 THINKING_BUDGET=10000 LOG_LEVEL=INFO TMUX_LAUNCH_MODE=unshare HOOKS_ENABLED=1 PROMPT_INCLUDE_DATETIME=1 PROMPT_INCLUDE_TOOLS=1
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
AGENTS_BASE_DIR |
string | โ | Base directory for agent workspaces | scorpiox-agent |
AGENTS_PAT |
string | โ | Git PAT for agents repository | scorpiox-agent |
AGENTS_REPO_URL |
string | โ | Git repository URL for agent definitions | scorpiox-agentscorpiox-sdk |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
CACHE_KEEPALIVE |
boolean | 0 |
Enable prompt cache keepalive pings | libsxutilsx_cache_keepalive |
CACHE_KEEPALIVE_MAX_PINGS |
string | 2 |
Maximum keepalive pings per session | libsxutilsx_cache_keepalive |
CACHE_KEEPALIVE_MAX_TRIES |
string | 1 |
Maximum keepalive retry attempts | libsxutilsx_cache_keepalive |
CACHE_KEEPALIVE_TRIGGER |
string | 270 |
Seconds of idle before sending keepalive | libsxutilsx_cache_keepalive |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
CONTAINER_PACKAGES |
string | none |
Packages to install in containers (none = skip) | libsxutilscorpiox-sdkscorpiox-tmuxscorpiox-unshare+1 |
IMAGE_BASE_URL |
string | https://dist.scorpiox.net/container-images/ |
Base URL for downloading container images | libsxutilscorpiox-unsharescorpiox-vmscorpiox-wsl |
PWSH_HOST |
string | localhost:3001 |
PowerShell over TCP host:port | libsxutil |
TMUX_BACKEND |
string | tmux |
Tmux multiplexer backend (tmux, sxmux) | libsxutilsxtmux_backend_sxmux |
TMUX_BIND_HOST_BINS |
boolean | 1 |
Bind-mount host binaries into container | libsxutilscorpiox-tmux |
TMUX_DEFAULT_DISTRO |
string | scorpiox-alpine |
Default Linux distribution for containers | libsxutilscorpiox-tmux |
TMUX_LAUNCH_MODE |
string | unshare |
Container launch mode (unshare, podman, wsl) | libsxutilscorpiox-tmux |
TMUX_MODE |
string | โ | Tmux mode (remote, local) | libsxutilscorpiox-tmuxsxtmux_backend_sxmux |
TMUX_PODMAN_EXTRA_ARGS |
string | โ | Extra arguments for Podman run | libsxutilscorpiox-tmux |
TMUX_PODMAN_IMAGE |
string | startauto:latest |
Container image for Podman | libsxutilscorpiox-tmux |
TMUX_PODMAN_REGISTRY |
string | โ | Container registry URL for Podman | libsxutilscorpiox-tmux |
TMUX_PODMAN_SCORPIOX_URL |
string | โ | URL to download scorpiox into Podman container | libsxutil |
TMUX_PODMAN_TLS_VERIFY |
string | false |
TLS verification for Podman registry | libsxutilscorpiox-tmux |
TMUX_PODMAN_VOLUME_MOUNT |
string | /codebases:/codebases |
Volume mount for Podman containers | libsxutilscorpiox-tmux |
TMUX_REMOTE_BASE |
string | /codebases |
Base directory on remote host | libsxutilscorpiox-tmux |
TMUX_REMOTE_HOST |
string | โ | Remote host for tmux remote mode | libsxutilscorpiox-tmux |
TMUX_SMB_SHARE |
string | โ | SMB share path for remote file access | libsxutilscorpiox-tmux |
TMUX_UNSHARE_EXTRA_ARGS |
string | โ | Extra arguments for unshare containers | libsxutilscorpiox-tmux |
TMUX_UNSHARE_NET_MODE |
string | โ | Network mode for unshare (host or isolated) | libsxutilscorpiox-tmux |
TMUX_UNSHARE_VOLUME_MOUNT |
string | โ | Volume mount for unshare containers | libsxutilscorpiox-tmux |
TMUX_WORKTREE_BASE |
string | โ | Base directory for git worktree operations | scorpiox-tmux |
TMUX_WSL_EXTRA_ARGS |
string | โ | Extra arguments for WSL containers | libsxutilscorpiox-tmux |
TMUX_WSL_VOLUME_MOUNT |
string | โ | Volume mount for WSL containers | libsxutilscorpiox-tmux |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
CONTEXT_AUTO_COMPACT |
boolean | 1 |
Enable automatic context compaction | libsxnetlibsxutil |
CONTEXT_CLEAR_THRESHOLD |
string | 190000 |
Token threshold to trigger context clear | libsxnetlibsxutil |
CONTEXT_WARN_THRESHOLD |
string | 80 |
Percentage threshold to warn about context usage | libsxnetlibsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
SCORPIOX_DIST_BASE_URL |
string | https://dist.scorpiox.net/scorpiox |
Base URL for scorpiox distribution downloads | libsxutil |
SCORPIOX_DIST_FILENAME |
string | scorpiox_code.tar.gz |
Distribution archive filename (platform-specific) | libsxutil |
SCORPIOX_INDEX_URL |
string | https://dist.scorpiox.net/scorpiox/index.txt |
URL for scorpiox distribution index file | libsxutil |
SCORPIOX_REGISTRY |
string | registry.scorpiox.net |
Container registry for scorpiox images | libsxutil |
UPDATE_URL |
string | โ | Custom URL for scorpiox self-update | libsxutilscorpiox-wsl |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
DNS_ACTIVE_CACHE |
boolean | โ | Enable active DNS cache refresh | scorpiox-dns |
DNS_ACTIVE_CACHE_FILE |
string | โ | Path to active cache entries file | scorpiox-dns |
DNS_AUDIT_LOG |
boolean | โ | Enable DNS query audit logging | scorpiox-dns |
DNS_AUDIT_LOG_DIR |
string | โ | Directory for DNS audit logs | scorpiox-dns |
DNS_DEFAULT_TTL |
integer | โ | Default TTL for DNS records (seconds) | scorpiox-dns |
DNS_DOMAIN |
string | โ | DNS server authoritative domain | scorpiox-dns |
DNS_LISTEN |
string | โ | DNS server listen address:port | scorpiox-dns |
DNS_PRECACHE |
boolean | โ | Enable DNS precaching | scorpiox-dns |
DNS_PRECACHE_FILE |
string | โ | Path to DNS precache entries file | scorpiox-dns |
DNS_UPSTREAM |
string | โ | Upstream DNS resolver for forwarding | scorpiox-dns |
DNS_ZONE_FILE |
string | โ | Path to DNS zone file | scorpiox-dns |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
EMAIL_ACCOUNTS_FILE |
string | โ | Path to email accounts file | scorpiox-server-email |
EMAIL_ALIASES_FILE |
string | โ | Path to email aliases file | scorpiox-server-email |
EMAIL_DKIM_DOMAIN |
string | โ | DKIM signing domain | scorpiox-server-email |
EMAIL_DKIM_KEY |
string | โ | Path to DKIM private key | scorpiox-server-email |
EMAIL_DKIM_SELECTOR |
string | โ | DKIM selector name | scorpiox-server-email |
EMAIL_DOMAIN |
string | โ | Email server domain | scorpiox-server-email |
EMAIL_IMAP_PORT |
integer | โ | Email server IMAP port | scorpiox-server-email |
EMAIL_MAILDIR |
string | โ | Base directory for email mailboxes | scorpiox-server-email |
EMAIL_RELAY_HOST |
string | โ | Email relay/smarthost hostname | scorpiox-server-email |
EMAIL_RELAY_PASS |
string | โ | Email relay authentication password | scorpiox-server-email |
EMAIL_RELAY_PORT |
integer | โ | Email relay port | scorpiox-server-email |
EMAIL_RELAY_TLS |
string | โ | TLS mode for email relay | scorpiox-server-email |
EMAIL_RELAY_USER |
string | โ | Email relay authentication username | scorpiox-server-email |
EMAIL_SMTP_PORT |
integer | โ | Email server SMTP port | scorpiox-server-email |
EMAIL_SUBMISSION_PORT |
integer | โ | Email server submission port (587) | scorpiox-server-email |
EMAIL_TLS_CERT |
string | โ | Path to TLS certificate for email server | scorpiox-server-email |
EMAIL_TLS_KEY |
string | โ | Path to TLS private key for email server | scorpiox-server-email |
SMTP_FROM |
string | โ | Default sender email address | libsxutilscorpiox-email |
SMTP_HOST |
string | โ | SMTP server hostname for sending email | libsxutilscorpiox-email |
SMTP_PASS |
string | โ | SMTP authentication password | libsxutilscorpiox-email |
SMTP_PORT |
string | 587 |
SMTP server port | libsxutilscorpiox-email |
SMTP_REQUIRE_TLS |
boolean | โ | Require TLS for SMTP connections | scorpiox-server-email |
SMTP_TLS |
string | starttls |
SMTP TLS mode (starttls, ssl, none) | libsxutilscorpiox-email |
SMTP_USER |
string | โ | SMTP authentication username | libsxutilscorpiox-email |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
IMSG_DB_PATH |
string | โ | Path to iMessage database | scorpiox-imessage |
IMSG_INBOX_DIR |
string | โ | Directory for iMessage inbox | scorpiox-imessage |
IMSG_LISTEN_SESSION |
string | โ | iMessage listener session name | scorpiox-imessage |
IMSG_POLL_INTERVAL |
integer | โ | iMessage polling interval (seconds) | scorpiox-imessage |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
MAPS_API_KEY |
string | โ | Direct API key for Google Maps | libsxutilscorpiox-googlemapsscorpiox-googleweather |
MAPS_API_URL |
string | https://maps.scorpiox.net |
Google Maps API proxy URL | libsxutilscorpiox-googlemaps |
MAPS_TOKEN_SOURCE |
string | tcp |
Token source for Maps API (tcp) | libsxutilscorpiox-googlemaps |
MAPS_TOKEN_URL |
string | https://token.scorpiox.net/maps |
Remote URL for Maps token fetching | libsxutilscorpiox-googlemapsscorpiox-googleweather |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
MCP |
boolean | 0 |
Enable Model Context Protocol support | libsxnetlibsxutil |
MCP_ALLOW |
string | โ | Allowed MCP tool patterns | libsxutil |
MCP_CONFIG |
string | โ | Path to MCP configuration file | libsxutil |
MCP_DENY |
string | โ | Denied MCP tool patterns | libsxutil |
MCP_FILE |
string | โ | MCP tools file path | libsxnetlibsxutilscorpiox-mcp |
MCP_SERVER |
string | โ | MCP server command/path | libsxutil |
MCP_SERVER_NAME |
string | โ | Display name for MCP server | libsxutilscorpiox-server |
MCP_TOOL_EXCLUDE |
string | โ | Comma-separated list of MCP tools to exclude | libsxutilscorpiox-server |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
MIRROR_GIT_MACHINES |
string | โ | Target machines for git mirror push | scorpiox-mirror-git |
MIRROR_GIT_ORIGIN |
string | โ | Source Git origin URL for mirroring | scorpiox-mirror-git |
MIRROR_GIT_PAT |
string | โ | Git PAT for mirror authentication | scorpiox-mirror-git |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
CLAUDE_MODEL_HAIKU_ID_OVERRIDE |
string | โ | Override the model ID used for haiku | libsxnetlibsxutil |
CLAUDE_MODEL_OPUS_ID_OVERRIDE |
string | โ | Override the model ID used for opus | libsxnetlibsxutil |
CLAUDE_MODEL_SONNET_ID_OVERRIDE |
string | โ | Override the model ID used for sonnet | libsxnetlibsxutil |
MODEL |
string | sonnet |
Model selection shorthand (opus, sonnet, haiku) | libsxnetlibsxutil |
THINKING |
boolean | 1 |
Enable extended thinking / chain-of-thought | libsxnetlibsxutil |
THINKING_BUDGET |
string | 10000 |
Token budget for extended thinking | libsxnetlibsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
CURL_CA_BUNDLE |
string | โ | Path to CA certificate bundle for TLS | libsxutil |
FETCHTOKEN_ACCESS_LOG |
boolean | โ | Enable access logging for fetchtoken | scorpiox-server-fetchtoken |
FETCHTOKEN_API_KEY |
string | โ | API key for fetchtoken server | scorpiox-server-fetchtoken |
FETCHTOKEN_API_KEYS |
string | โ | Multiple API keys (comma-separated) | scorpiox-server-fetchtoken |
FETCHTOKEN_API_KEY_REQUIRED |
boolean | โ | Require API key for fetchtoken access | scorpiox-server-fetchtoken |
FETCHTOKEN_IP_WHITELIST |
string | โ | IP whitelist for fetchtoken server | scorpiox-server-fetchtoken |
FETCHTOKEN_LISTEN_PORT |
string | 9800 |
Port for the local fetchtoken listener server | libsxutilscorpiox-server-fetchtoken |
FETCHTOKEN_UPSTREAM_BASE |
string | โ | Upstream base URL for fetchtoken proxy | scorpiox-server-fetchtoken |
HTTP_RELAY |
boolean | 0 |
Enable HTTP relay mode | libsxnetlibsxutil |
HTTP_RELAY_HOST |
string | โ | HTTP relay server host | libsxnetlibsxutil |
HTTP_RELAY_KEY |
string | โ | API key for HTTP relay authentication | libsxnetlibsxutil |
HTTP_RELAY_PORT |
string | 9801 |
HTTP relay server port | libsxnetlibsxutilscorpiox-server-http2tcp |
TCP_API_KEY |
string | โ | API key for TCP proxy authentication | libsxnetlibsxutilscorpiox-claudecode-fetchtokenscorpiox-codex-fetchtoken+3 |
TCP_HOST |
string | proxy.scorpiox.net |
TCP proxy host for token relay | libsxnetlibsxutilscorpiox-claudecode-fetchtokenscorpiox-codex-fetchtoken+3 |
TCP_PORT |
string | 9800 |
TCP proxy port for token relay | libsxnetlibsxutilscorpiox-claudecode-fetchtokenscorpiox-codex-fetchtoken+3 |
WASM_API_PROXY |
string | โ | API proxy URL for WASM builds | libsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
HOOKS_ENABLED |
boolean | 1 |
Enable lifecycle hooks | libsxutil |
HOOKS_TIMEOUT |
string | 30 |
Timeout in seconds for hook execution | libsxutil |
PERMISSIONS_BASH |
boolean | 0 |
Enable bash permission checking | libsxnetlibsxuilibsxutil |
PERMISSIONS_BASH_ALLOW |
string | โ | Allowed bash command patterns (comma-separated) | libsxutil |
PERMISSIONS_BASH_DENY |
string | โ | Denied bash command patterns (comma-separated) | libsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
PATCH_EDIT |
boolean | 1 |
Enable patch-based file editing (unified diff) | libsxutil |
PROMPT_DATETIME_FORMAT |
string | %Y-%m-%d %H:%M:%S %Z |
strftime format for date/time in prompt | libsxutil |
PROMPT_INCLUDE_CLAUDEMD |
boolean | 1 |
Include CLAUDE.md project instructions in prompt | libsxutil |
PROMPT_INCLUDE_CWD |
boolean | 1 |
Include current working directory in system prompt | libsxutil |
PROMPT_INCLUDE_DATETIME |
boolean | 1 |
Include current date/time in system prompt | libsxutil |
PROMPT_INCLUDE_OS |
boolean | 1 |
Include OS information in system prompt | libsxutil |
PROMPT_INCLUDE_TIMEZONE |
boolean | 1 |
Include timezone in system prompt | libsxutil |
PROMPT_INCLUDE_TOOLS |
boolean | โ | Include tool descriptions in system prompt | libsxutil |
PROMPT_INCLUDE_TREE |
boolean | 0 |
Include directory tree in system prompt | libsxutil |
PROMPT_TIMEZONE |
string | Pacific/Auckland |
Timezone for date/time display (IANA format) | libsxutil |
PROMPT_TREE_DEPTH |
string | 3 |
Maximum depth for directory tree | libsxutil |
PROMPT_TREE_IGNORE |
string | .git,node_modules,build,__pycache__ |
Patterns to ignore in directory tree | libsxutil |
PROMPT_TREE_MAX_FILES |
string | 100 |
Maximum files to show in directory tree | libsxutil |
SYSTEM_PROMPT |
string | You are Claude Code, Anthropic's official CLI for Claude. |
Base system prompt sent to the LLM | libsxutil |
USER_SYSTEM_REMINDER |
boolean | 0 |
Append user-defined reminder to system prompt | libsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
ANTHROPIC_ANTIGRAVITY_KEY |
string | โ | API key for Antigravity proxy | libsxnetlibsxutil |
ANTHROPIC_ANTIGRAVITY_URL |
string | โ | Base URL for Antigravity proxy | libsxnetlibsxutil |
ANTHROPIC_API_KEY |
string | โ | API key for Anthropic Claude direct access | libsxnetlibsxutil |
ANTHROPIC_API_URL |
string | https://api.anthropic.com/v1/messages |
Base URL for Anthropic API requests | libsxnetlibsxutil |
ANTHROPIC_AUTH_PROVIDER |
string | official |
Authentication provider for Anthropic (official, antigravity, zai, custom) | libsxnetlibsxutil |
ANTHROPIC_ZAI_KEY |
string | โ | API key for Z.AI proxy | libsxnetlibsxutil |
ANTHROPIC_ZAI_URL |
string | https://api.z.ai/api/anthropic/v1/messages |
Base URL for Z.AI Anthropic proxy | libsxnetlibsxutil |
API_BACKEND |
string | claude |
Backend engine when using scorpiox provider (claude, gemini, glm, llamacpp) | libsxnetlibsxutil |
CLAUDE_CODE_API_URL |
string | api.anthropic.com |
API hostname for Claude Code provider | libsxnetlibsxutil |
CLAUDE_CODE_PROXY_ENABLED |
boolean | 0 |
Enable proxy routing for Claude Code requests | libsxnetlibsxutil |
CLAUDE_CODE_PROXY_STRICT |
boolean | 0 |
Strict proxy mode โ fail if proxy unreachable | libsxnetlibsxutil |
CLAUDE_CODE_PROXY_URL |
string | anthropic.scorpiox.net |
Proxy hostname for Claude Code requests | libsxnetlibsxutil |
CLAUDE_CODE_REMOTE_URL |
string | https://token.scorpiox.net/claude |
Remote HTTP URL for Claude Code token fetching | libsxnetlibsxutilscorpiox-claudecode-fetchtoken |
CLAUDE_CODE_SSH_HOST |
string | โ | SSH host for Claude Code token fetching | libsxutilscorpiox-claudecode-fetchtoken |
CLAUDE_CODE_SSH_PASS |
string | โ | SSH password for Claude Code token fetching | libsxutilscorpiox-claudecode-fetchtoken |
CLAUDE_CODE_SSH_PORT |
string | โ | SSH port for Claude Code token fetching | libsxutilscorpiox-claudecode-fetchtoken |
CLAUDE_CODE_SSH_USER |
string | โ | SSH username for Claude Code token fetching | libsxutilscorpiox-claudecode-fetchtoken |
CLAUDE_CODE_TOKEN_SOURCE |
string | local |
How to obtain Claude Code authentication tokens (local, http, ssh, tcp) | libsxnetlibsxutilscorpiox-claudecode-fetchtoken |
CODEX_REMOTE_URL |
string | https://token.scorpiox.net/codex |
Remote HTTP URL for Codex token fetching | libsxutilscorpiox-codex-fetchtoken |
CODEX_SSH_HOST |
string | โ | SSH host for Codex token fetching | libsxutilscorpiox-codex-fetchtoken |
CODEX_SSH_PASS |
string | โ | SSH password for Codex token fetching | libsxutilscorpiox-codex-fetchtoken |
CODEX_SSH_PORT |
string | โ | SSH port for Codex token fetching | libsxutilscorpiox-codex-fetchtoken |
CODEX_SSH_USER |
string | โ | SSH username for Codex token fetching | libsxutilscorpiox-codex-fetchtoken |
CODEX_TOKEN_SOURCE |
string | tcp |
How to obtain Codex authentication tokens | libsxnetlibsxutilscorpiox-codex-fetchtoken |
GEMINI_API_KEY |
string | โ | API key for Google Gemini | libsxutil |
GEMINI_BASE_URL |
string | โ | Custom base URL for Gemini API | libsxutil |
GEMINI_MODEL |
string | gemini-3.1-pro-preview |
Default Gemini model to use | libsxutil |
GEMINI_REMOTE_URL |
string | https://google-accounts.scorpiox.net/token |
Remote URL for Gemini token fetching | libsxutil |
GEMINI_TOKEN_SOURCE |
string | remote |
How to obtain Gemini tokens (remote) | libsxutil |
GOOGLE_ACCOUNT |
string | โ | Google account email for OAuth | libsxnetscorpiox-google-fetchtokenscorpiox-google-models |
GOOGLE_CLAUDE_MODEL |
string | โ | Claude model to use via Google Cloud | libsxnetscorpiox-google-claude |
GOOGLE_GEMINI_MODEL |
string | โ | Gemini model to use via Google Cloud | libsxnetscorpiox-google-gemini |
GOOGLE_REMOTE_URL |
string | https://google-accounts.scorpiox.net/token |
Remote URL for Google token fetching | libsxnetlibsxutilscorpiox-google-fetchtokenscorpiox-google-models |
GOOGLE_TOKEN_SOURCE |
string | tcp |
How to obtain Google tokens (remote, tcp) | libsxnetlibsxutilscorpiox-google-fetchtoken |
OPENAI_API_BASE |
string | โ | Alternative base URL for OpenAI API (fallback) | libsxnetlibsxutilscorpiox-openai |
OPENAI_API_KEY |
string | โ | API key for OpenAI | libsxnetlibsxutilscorpiox-openai |
OPENAI_BASE_URL |
string | โ | Custom base URL for OpenAI API | libsxnetlibsxutilscorpiox-openai |
OPENAI_MODEL |
string | โ | OpenAI model to use | libsxnetlibsxutil |
OPENAI_TIMEOUT |
string | โ | Request timeout for OpenAI API calls (seconds) | libsxnetscorpiox-openai |
PROVIDER |
string | scorpiox |
Active LLM provider backend | libsxutil |
ROUTER_URL |
string | โ | URL for the scorpiox router/load-balancer | libsxnetlibsxutil |
STREAMING |
boolean | 0 |
Enable streaming responses from the LLM | libsxnetlibsxutil |
VERTEX_API_KEY |
string | โ | API key for Google Vertex AI | libsxnetscorpiox-gemini-vertexscorpiox-vertex-models |
VERTEX_MODEL |
string | โ | Model to use with Vertex AI | libsxnetscorpiox-gemini-vertex |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
SERVER_FAVICON |
string | โ | Path to server favicon | scorpiox-server |
SERVER_GIT_CACHE_DIR |
string | โ | Directory for server git cache | scorpiox-server |
SERVER_GIT_PAT |
string | โ | Git personal access token for server | scorpiox-server |
SERVER_GIT_POLL_INTERVAL |
integer | โ | Git polling interval (seconds) | scorpiox-server |
SERVER_IP_WHITELIST |
string | โ | IP whitelist for server access | scorpiox-server |
SERVER_JWT_AUDIENCE |
string | โ | Expected JWT audience | scorpiox-server |
SERVER_JWT_CLAIMS |
string | โ | Required JWT claims (key=value) | scorpiox-server |
SERVER_JWT_COOKIE |
string | โ | Cookie name for JWT token | scorpiox-server |
SERVER_JWT_ISSUER |
string | โ | Expected JWT issuer | scorpiox-server |
SERVER_JWT_LOGIN_URL |
string | โ | Redirect URL for unauthenticated requests | scorpiox-server |
SERVER_JWT_PROTECT |
string | โ | URL patterns requiring JWT auth | scorpiox-server |
SERVER_JWT_SECRET |
string | โ | JWT signing secret for server auth | scorpiox-server |
SERVER_MAX_REQUEST_MB |
integer | โ | Maximum request body size (MB) | scorpiox-server |
SERVER_MAX_RESPONSE_MB |
integer | โ | Maximum response body size (MB) | scorpiox-server |
SERVER_PORT |
integer | โ | HTTP server listen port | scorpiox-server |
SERVER_ROUTE_PREFIX |
string | โ | URL path prefix for server routes | scorpiox-server |
SERVER_SCRIPT_DIR |
string | โ | Directory for server-side scripts | scorpiox-server |
SERVER_SCRIPT_TIMEOUT |
integer | โ | Timeout for server script execution (seconds) | scorpiox-server |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
AGENTLESS_MODE |
boolean | 0 |
Run in agentless mode (no sub-agents) | libsxutil |
AGENT_MAX_RECURSION_DEPTH |
integer | 10 |
Maximum recursion depth for nested agent calls | libsxnetlibsxutil |
ASKUSER_TIMEOUT |
string | 120 |
Timeout in seconds for AskUserQuestion prompts | libsxnetlibsxutil |
AUTO_ACCEPT_PLAN |
boolean | 1 |
Auto-accept plans without user confirmation | libsxnetlibsxutil |
BASH_DEFAULT_TIMEOUT |
string | 30000 |
Default timeout in ms for Bash tool execution | libsxnetlibsxutil |
BASH_MIN_TIMEOUT |
string | 0 |
Minimum timeout in ms for Bash tool (0 = no minimum) | libsxnetlibsxutil |
LOG_DIR |
string | .scorpiox/logs |
Directory for session logs | libsxutilscorpiox-logger |
LOG_LEVEL |
string | INFO |
Logging verbosity level (DEBUG, INFO, WARN, ERROR) | libsxutil |
PROJECT_DIR |
string | โ | Project directory override for CLAUDE.md search | scorpiox-email |
SESSION_RETENTION_DAYS |
string | 7 |
Days to retain session logs | libsxutilsx |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
REQUIRED_SKILLS |
boolean | 1 |
Enable required skills loading from CLAUDE.md | libsxnetlibsxutil |
REQUIRED_SKILLS_FORCED |
boolean | 0 |
Force-load required skills even if disabled by user | libsxnetlibsxutil |
SKILL_CREATE_COMMAND |
boolean | 1 |
Enable built-in create-command skill | libsxutil |
SKILL_CREATE_SKILL |
boolean | 1 |
Enable built-in create-skill skill | libsxutil |
SKILL_EDIT_COMMAND |
boolean | 1 |
Enable built-in edit-command skill | libsxutil |
SKILL_EDIT_SKILL |
boolean | 1 |
Enable built-in edit-skill skill | libsxutil |
SKILL_FAST_CLONE |
boolean | 0 |
Enable fast-clone skill | libsxutil |
SKILL_FAST_CLONE_INSTRUCTIONS |
boolean | 0 |
Enable fast-clone-instructions skill | libsxutil |
SKILL_GOOGLEMAPS |
boolean | 1 |
Enable built-in Google Maps skill | libsxutil |
SKILL_PREFERRED_FILE_TOOLS |
boolean | 1 |
Enable preferred-file-tools skill | libsxutil |
SKILL_WINDOWS_DESKTOP_SCREENSHOT |
boolean | 1 |
Enable Windows desktop screenshot skill | libsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
READDOCS_COMMAND |
string | scorpiox-fetch |
External command for ReadDocs URL fetching | libsxnetlibsxutil |
SCORPIOX_DOCS_PYTHON |
string | โ | Python binary for docs fetching | scorpiox-docs |
SCORPIOX_DOCS_WAIT |
integer | โ | Wait time for docs page load (ms) | scorpiox-docs |
SCORPIOX_SEARCH_ENGINES |
string | โ | Search engines to use (comma-separated) | scorpiox-search |
SCORPIOX_SEARCH_NUM |
integer | โ | Number of search results to return | scorpiox-search |
SCORPIOX_SEARCH_PYTHON |
string | โ | Python binary for web search | scorpiox-search |
SCORPIOX_SEARCH_WAIT |
integer | โ | Wait time for search results (ms) | scorpiox-search |
TOOLS |
boolean | 1 |
Master toggle โ enable/disable all tool use | libsxnetlibsxutil |
TOOL_ASKUSERQUESTION |
boolean | 1 |
Enable the AskUserQuestion tool | libsxutil |
TOOL_BACKGROUNDBASH |
boolean | 1 |
Enable the BackgroundBash tool | libsxutil |
TOOL_BASH |
boolean | 1 |
Enable the Bash tool | libsxutil |
TOOL_EMITEVENT |
boolean | 0 |
Enable the EmitEvent tool (agent events) | libsxutil |
TOOL_INVOKESKILL |
boolean | 1 |
Enable the InvokeSkill tool | libsxutil |
TOOL_KILLBGTASK |
boolean | 1 |
Enable the KillBgTask tool | libsxutil |
TOOL_LISTBGTASKS |
boolean | 1 |
Enable the ListBgTasks tool | libsxutil |
TOOL_PLANMODE |
boolean | 1 |
Enable the PlanMode tool | libsxutil |
TOOL_READBGOUTPUT |
boolean | 1 |
Enable the ReadBgOutput tool | libsxutil |
TOOL_READDOCS |
boolean | 1 |
Enable the ReadDocs tool | libsxutil |
TOOL_READIMAGE |
boolean | 1 |
Enable the ReadImage tool | libsxutil |
TOOL_TASKMANAGER |
boolean | 1 |
Enable the TaskManager tool | libsxutil |
TOOL_WEBSEARCH |
boolean | 1 |
Enable the WebSearch tool | libsxutil |
WEBSEARCH_COMMAND |
string | scorpiox-websearch |
External command for WebSearch | libsxnetlibsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
ENABLE_GRADIENT |
boolean | 0 |
Enable gradient coloring in TUI | libsxnetlibsxutil |
ENABLE_TERM_BACKGROUND |
boolean | 1 |
Enable terminal background effects | libsxutilsx_term |
ENABLE_TEXT_BG |
boolean | 1 |
Enable text background coloring | libsxnetlibsxutil |
ENABLE_WELCOME |
boolean | 1 |
Show welcome banner on startup | libsxnetlibsxutil |
TUI_FULL_REFRESH |
string | 10 |
Full TUI redraw interval (ms, 0 = disabled) | libsxutil |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
EMIT_SESSION_API_URL |
string | โ | API endpoint for session event data | libsxutilscorpiox-emit-session |
EMIT_SESSION_TRACKING |
boolean | 0 |
Enable session event emission | libsxutilscorpiox-emit-sessionsx |
USAGE_API_URL |
string | โ | API endpoint for usage tracking data | libsxutilscorpiox-usage |
USAGE_TRACKING |
boolean | 0 |
Enable usage/telemetry tracking | libsxnetlibsxutilscorpiox-usage |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
VOICE_WHISPER_URL |
string | โ | URL for Whisper speech-to-text service | scorpiox-voice |
| Key | Type | Default | Description | Used By |
|---|---|---|---|---|
WA_AUTH_DIR |
string | .scorpiox/whatsapp/auth |
Directory for WhatsApp authentication data | libsxutilscorpiox-whatsapp |
WA_BRIDGE_AUTO_UPDATE |
string | on-demand |
WhatsApp bridge auto-update mode (on-demand, auto, disabled) | libsxutil |
WA_BRIDGE_PATH |
string | โ | Path to WhatsApp bridge binary | libsxutilscorpiox-whatsapp |
WA_INBOX_DIR |
string | .scorpiox/whatsapp/inbox |
Directory for WhatsApp inbox messages | libsxutilscorpiox-whatsapp |
WA_LISTEN_SESSION |
string | โ | WhatsApp listener session name | libsxutilscorpiox-whatsapp |