配置參考

25 個類別中的 200 個配置鍵。全部從 scorpiox-env.txt 讀取 — 平面 key=value 檔案。無 YAML、無 TOML、無 JSON。純粹簡潔,用 C 解析。

200
Config Keys
25
Categories
0
Dependencies
1
Config File

檔案位置

scorpiox code 使用簡單的 KEY=value 格式從 scorpiox-env.txt 讀取配置。解析器使用純 C 實現,零外部依賴。按順序搜索三個位置:

1/scorpiox-env.txt
2~/.scorpiox/scorpiox-env.txt
3.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

Agents 5

類型 預設 描述 使用者
AGENTS_BASE_DIR path Base directory for agent working directories scorpiox-agent
AGENTS_CWD string Working directory override for agent execution scorpiox-agent
AGENTS_INSTANCE_ID string Unique instance identifier for agent process scorpiox-agent
AGENTS_PAT string Personal access token for agents git repo scorpiox-agent
AGENTS_REPO_URL path Git repository URL for agent task definitions scorpiox-agentscorpiox-sdk

Container 21

類型 預設 描述 使用者
INIT_TOOLS string Comma-separated tool filter for scorpiox-init bootstrap scorpiox-init
SXMUX_INIT_CMD string Initial command to run in new sxmux sessions sx
TMUX_BACKEND string tmux Tmux multiplexer backend (tmux, sxmux) scorpiox-configscorpiox-tmuxsx
TMUX_DEFAULT_DISTRO string scorpiox-alpine Default Linux distribution for container sessions scorpiox-configscorpiox-tmuxsx
TMUX_LAUNCH_MODE string unshare Container launch method (unshare, podman, wsl) scorpiox-configscorpiox-tmuxsx
TMUX_MODE string Tmux operation mode (local, remote, empty for auto) scorpiox-configscorpiox-tmuxsx
TMUX_PODMAN_EXTRA_ARGS string Extra arguments for podman run command scorpiox-configscorpiox-tmuxsx
TMUX_PODMAN_IMAGE string startauto:latest Podman container image name scorpiox-configscorpiox-tmuxsx
TMUX_PODMAN_REGISTRY string Podman container registry URL scorpiox-configscorpiox-tmuxsx
TMUX_PODMAN_SCORPIOX_URL path URL to fetch scorpiox binaries inside podman container scorpiox-configsx
TMUX_PODMAN_TLS_VERIFY string false Enable TLS verification for podman registry scorpiox-configscorpiox-tmuxsx
TMUX_PODMAN_VOLUME_MOUNT string /Volumes/GitHub:/Volumes/GitHub Volume mount spec for podman containers scorpiox-configscorpiox-tmuxsx
TMUX_REMOTE_BASE string /Volumes/GitHub Base directory on remote host for tmux sessions scorpiox-configscorpiox-tmuxsx
TMUX_REMOTE_HOST string Remote host for tmux SSH connections scorpiox-configscorpiox-tmuxsx
TMUX_SMB_SHARE string SMB share path for tmux file access scorpiox-configscorpiox-tmuxsx
TMUX_UNSHARE_EXTRA_ARGS string Extra arguments for unshare command scorpiox-configscorpiox-tmuxsx
TMUX_UNSHARE_NET_MODE string Network mode for unshare containers scorpiox-configscorpiox-tmuxsx
TMUX_UNSHARE_VOLUME_MOUNT string Volume mount spec for unshare containers scorpiox-configscorpiox-tmuxsx
TMUX_WORKTREE_BASE string Base directory for git worktree sessions scorpiox-tmux
TMUX_WSL_EXTRA_ARGS string Extra arguments for WSL launch scorpiox-configscorpiox-tmuxsx
TMUX_WSL_VOLUME_MOUNT string Volume mount spec for WSL containers scorpiox-configscorpiox-tmuxsx

Distribution 7

類型 預設 描述 使用者
CONTAINER_PACKAGES string Additional packages to install in containers scorpiox-configscorpiox-sdkscorpiox-unsharescorpiox-wsl+1
IMAGE_BASE_URL path https://dist.scorpiox.net/container-images/ Base URL for downloading container images scorpiox-configscorpiox-unsharescorpiox-vmscorpiox-wsl+1
SCORPIOX_DIST_BASE_URL path https://dist.scorpiox.net/scorpiox Base URL for scorpiox distribution downloads scorpiox-configscorpiox-podmanscorpiox-tmuxsx
SCORPIOX_DIST_FILENAME string Distribution archive filename (platform-specific) scorpiox-configsx
SCORPIOX_INDEX_URL path https://dist.scorpiox.net/scorpiox/index.txt URL for scorpiox release index file scorpiox-configsx
SCORPIOX_REGISTRY string registry.scorpiox.net Container registry for scorpiox images scorpiox-configscorpiox-podmansx
UPDATE_URL path URL for checking scorpiox updates scorpiox-configscorpiox-wslsx

Dns 5

類型 預設 描述 使用者
DNS_DEFAULT_TTL integer Default TTL for DNS records in seconds scorpiox-dns
DNS_DOMAIN string DNS domain name to serve scorpiox-dns
DNS_LISTEN string DNS server listen address:port scorpiox-dns
DNS_UPSTREAM string Upstream DNS resolver address scorpiox-dns
DNS_ZONE_FILE path Path to DNS zone file scorpiox-dns

Docs 2

類型 預設 描述 使用者
SCORPIOX_DOCS_PYTHON string Python3 interpreter path for ReadDocs tool scorpiox-docs
SCORPIOX_DOCS_WAIT string Default page load wait time in ms for ReadDocs scorpiox-docs

Email 18

類型 預設 描述 使用者
EMAIL_ACCOUNTS_FILE path Path to email accounts configuration file scorpiox-server-email
EMAIL_ALIASES_FILE path 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 file scorpiox-server-email
EMAIL_DKIM_SELECTOR string DKIM DNS selector name scorpiox-server-email
EMAIL_DOMAIN string Email server domain name scorpiox-server-email
EMAIL_IMAP_PORT integer Email server IMAP port scorpiox-server-email
EMAIL_MAILDIR string Path to maildir storage directory scorpiox-server-email
EMAIL_SMTP_PORT integer Email server SMTP port scorpiox-server-email
EMAIL_SUBMISSION_PORT integer Email server submission port 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 SMTP sender email address scorpiox-configscorpiox-emailsx
SMTP_HOST string SMTP server hostname for sending email scorpiox-configscorpiox-emailsx
SMTP_PASS string SMTP authentication password scorpiox-configscorpiox-emailsx
SMTP_PORT integer 587 SMTP server port scorpiox-configscorpiox-emailscorpiox-server-emailsx
SMTP_TLS string starttls SMTP TLS mode (starttls, tls, none) scorpiox-configscorpiox-emailsx
SMTP_USER string SMTP authentication username scorpiox-configscorpiox-emailsx

Hooks 2

類型 預設 描述 使用者
HOOKS_ENABLED boolean 1 Enable pre/post hook scripts scorpiox-configsx
HOOKS_TIMEOUT integer 30 Timeout in seconds for hook script execution scorpiox-configsx

Imessage 4

類型 預設 描述 使用者
IMSG_DB_PATH path Path to iMessage chat.db database scorpiox-imessage
IMSG_INBOX_DIR path Directory for iMessage inbox queue files scorpiox-imessage
IMSG_LISTEN_SESSION string Session name for iMessage listener scorpiox-imessage
IMSG_POLL_INTERVAL integer Seconds between iMessage database polls scorpiox-imessage

Logging 2

類型 預設 描述 使用者
LOG_DIR path .scorpiox/logs Directory for log files scorpiox-configscorpiox-loggersx
LOG_LEVEL string INFO Logging verbosity (DEBUG, INFO, WARN, ERROR) scorpiox-configsx

Mcp 6

類型 預設 描述 使用者
MCP boolean 0 Enable Model Context Protocol support scorpiox-agentscorpiox-configscorpiox-hookscorpiox-mcp+2
MCP_ALLOW string MCP tool allow pattern (server:glob_pattern) scorpiox-configscorpiox-mcpsx
MCP_CONFIG string Path to MCP servers JSON configuration file scorpiox-configscorpiox-mcpsx
MCP_DENY string MCP tool deny pattern (server:glob_pattern) scorpiox-configscorpiox-mcpsx
MCP_FILE path Path to MCP configuration file scorpiox-agentscorpiox-configscorpiox-mcpsx
MCP_SERVER string Inline MCP server definition (name:command:arg1,arg2,...) scorpiox-configscorpiox-mcpsx

Mirror 3

類型 預設 描述 使用者
MIRROR_GIT_MACHINES string Comma-separated target machines for git mirror scorpiox-mirror-git
MIRROR_GIT_ORIGIN string Origin git server URL for mirroring scorpiox-mirror-git
MIRROR_GIT_PAT string Personal access token for git mirror operations scorpiox-mirror-git

Network 1

類型 預設 描述 使用者
PWSH_HOST string localhost:3001 Host:port for PowerShell bridge connection scorpiox-configscorpiox-pwshsx

Prompt 14

類型 預設 描述 使用者
PATCH_EDIT boolean 1 Enable unified diff patch-based file editing scorpiox-configsx
PROMPT_DATETIME_FORMAT string %Y-%m-%d %H:%M:%S %Z strftime format for datetime in prompt scorpiox-configscorpiox-systempromptsx
PROMPT_INCLUDE_CLAUDEMD boolean 1 Include CLAUDE.md project instructions in prompt scorpiox-configsx
PROMPT_INCLUDE_CWD boolean 1 Include current working directory in system prompt scorpiox-configscorpiox-systempromptsx
PROMPT_INCLUDE_DATETIME boolean 1 Include current date/time in system prompt scorpiox-configscorpiox-systempromptsx
PROMPT_INCLUDE_OS boolean 1 Include OS information in system prompt scorpiox-configscorpiox-systempromptsx
PROMPT_INCLUDE_TIMEZONE boolean 1 Include timezone in system prompt scorpiox-configscorpiox-systempromptsx
PROMPT_INCLUDE_TOOLS boolean Include tool descriptions in system prompt sx
PROMPT_INCLUDE_TREE boolean 0 Include directory tree in system prompt scorpiox-configsx
PROMPT_TREE_DEPTH integer 3 Maximum depth for directory tree in prompt scorpiox-configsx
PROMPT_TREE_IGNORE string .git,node_modules,build,__pycache__ Comma-separated patterns to ignore in tree scorpiox-configsx
PROMPT_TREE_MAX_FILES integer 100 Maximum files to show in directory tree scorpiox-configsx
SYSTEM_PROMPT string You are Claude Code, Anthropic's official CLI for Claude. Base system prompt for the AI assistant scorpiox-configscorpiox-systempromptsx
USER_SYSTEM_REMINDER boolean 0 Include user system reminder in conversation scorpiox-configsx

Provider 46

類型 預設 描述 使用者
ANTHROPIC_ANTIGRAVITY_KEY string API key for Antigravity proxy scorpiox-configsx
ANTHROPIC_ANTIGRAVITY_URL path http://192.168.1.12:8045/v1/messages URL for Antigravity proxy endpoint scorpiox-configsx
ANTHROPIC_API_KEY string API key for Anthropic Claude direct access scorpiox-configsx
ANTHROPIC_API_URL path https://api.anthropic.com/v1/messages Anthropic API endpoint URL scorpiox-configsx
ANTHROPIC_AUTH_PROVIDER string official Anthropic authentication provider (official, antigravity, zai) scorpiox-configsx
ANTHROPIC_ZAI_KEY string API key for Z.AI proxy scorpiox-configsx
ANTHROPIC_ZAI_URL path https://api.z.ai/api/anthropic/v1/messages URL for Z.AI proxy endpoint scorpiox-configsx
API_BACKEND string claude Backend API type (claude, openai, gemini) scorpiox-configsx
API_KEY string Generic API key (fallback) scorpiox-configscorpiox-geminiscorpiox-openaiscorpiox-spaceship-cli+1
CLAUDE_CODE_API_URL path api.anthropic.com Claude Code API hostname scorpiox-configsx
CLAUDE_CODE_CLIENT_ID string OAuth client ID for Claude Code scorpiox-claudecode-fetchtoken
CLAUDE_CODE_PROXY_ENABLED boolean 0 Enable proxy for Claude Code connections scorpiox-configsx
CLAUDE_CODE_PROXY_STRICT boolean 0 Strict proxy mode - fail if proxy unreachable scorpiox-configsx
CLAUDE_CODE_PROXY_URL path anthropic.scorpiox.net Proxy hostname for Claude Code API scorpiox-configsx
CLAUDE_CODE_REMOTE_URL path https://gcp.scorpioplayer.com/api/platform/websites/token_claude_max_api Remote URL for fetching Claude Code tokens scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_CODE_SSH_HOST string SSH host for remote Claude Code token fetching scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_CODE_SSH_PASS string SSH password for remote Claude Code token fetching scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_CODE_SSH_PORT integer SSH port for remote Claude Code token fetching scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_CODE_SSH_USER string SSH user for remote Claude Code token fetching scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_CODE_TOKEN_SOURCE string local Token source for Claude Code (local, remote, ssh) scorpiox-claudecode-fetchtokenscorpiox-configsx
CLAUDE_TOKEN_MODE string Claude token acquisition mode override (env var only) sx
CODEX_REMOTE_URL path https://gcp.scorpioplayer.com/api/platform/websites/token_codex_api Remote URL for fetching Codex tokens scorpiox-codex-fetchtokenscorpiox-configsx
CODEX_SSH_HOST string SSH host for remote Codex token fetching scorpiox-codex-fetchtokenscorpiox-configsx
CODEX_SSH_PASS string SSH password for remote Codex token fetching scorpiox-codex-fetchtokenscorpiox-configsx
CODEX_SSH_PORT integer SSH port for remote Codex token fetching scorpiox-codex-fetchtokenscorpiox-configsx
CODEX_SSH_USER string SSH user for remote Codex token fetching scorpiox-codex-fetchtokenscorpiox-configsx
CODEX_TOKEN_SOURCE string local Token source for OpenAI Codex (local, remote, ssh) scorpiox-codex-fetchtokenscorpiox-configsx
GEMINI_API_KEY string API key for Google Gemini scorpiox-configscorpiox-geminisx
GEMINI_BASE_URL path Custom base URL for Gemini API scorpiox-configscorpiox-geminisx
GEMINI_CACHE_ENABLED boolean Enable Gemini context caching scorpiox-gemini
GEMINI_CACHE_FILE path Path to Gemini cache storage file scorpiox-geminisx
GEMINI_CACHE_TTL integer TTL in seconds for Gemini cached contexts scorpiox-gemini
GEMINI_MODEL string gemini-3.1-pro-preview Model name for Gemini provider scorpiox-configsx
GEMINI_TRAFFIC_DIR path Directory for Gemini API traffic logs scorpiox-geminisx
GEMINI_TRAFFIC_SEQ integer Sequence counter for Gemini traffic log files scorpiox-geminisx
MODEL string sonnet Model name/alias to use (e.g. sonnet, opus, haiku) scorpiox-configscorpiox-hostscorpiox-sdksx
OPENAI_API_KEY string xxx API key for OpenAI scorpiox-configscorpiox-openaisx
OPENAI_BASE_URL path Custom base URL for OpenAI-compatible API scorpiox-configscorpiox-openaisx
OPENAI_MODEL string Model name for OpenAI provider scorpiox-configsx
OPENAI_TRAFFIC_DIR path Directory for OpenAI API traffic logs scorpiox-openaisx
OPENAI_TRAFFIC_SEQ integer Sequence counter for OpenAI traffic log files scorpiox-openaisx
PROVIDER string scorpiox AI provider backend to use (scorpiox, anthropic, claude_code, gemini, openai, codex) scorpiox-configscorpiox-sdksx
ROUTER_URL path URL for API router/load balancer scorpiox-configsx
STREAMING boolean 0 Enable streaming responses from the API scorpiox-configscorpiox-serversx
THINKING boolean 1 Enable extended thinking/reasoning mode scorpiox-configscorpiox-hostsxsxui_display
THINKING_BUDGET integer 10000 Token budget for thinking/reasoning scorpiox-configsx

Server 13

類型 預設 描述 使用者
SERVER_GIT_CACHE_DIR path Directory for caching git repositories scorpiox-server
SERVER_GIT_PAT string Personal access token for server git operations scorpiox-server
SERVER_GIT_POLL_INTERVAL integer Seconds between git repository poll checks scorpiox-server
SERVER_JWT_AUDIENCE string JWT token audience claim scorpiox-server
SERVER_JWT_COOKIE string Cookie name for JWT token storage scorpiox-server
SERVER_JWT_ISSUER string JWT token issuer claim scorpiox-server
SERVER_JWT_SECRET string Secret key for JWT token signing scorpiox-server
SERVER_MAX_REQUEST_MB integer Maximum request body size in MB scorpiox-server
SERVER_MAX_RESPONSE_MB integer Maximum response body size in MB scorpiox-server
SERVER_PORT integer HTTP server listen port scorpiox-server
SERVER_ROUTE_PREFIX string URL prefix for server routes scorpiox-server
SERVER_SCRIPT_DIR path Directory containing server-side scripts scorpiox-server
SERVER_SCRIPT_TIMEOUT integer Timeout in seconds for server script execution scorpiox-server

Session 5

類型 預設 描述 使用者
CACHE_KEEPALIVE boolean 0 Enable cache keepalive pings to maintain prompt cache scorpiox-configsx
CACHE_KEEPALIVE_MAX_PINGS integer 2 Maximum keepalive pings per session scorpiox-configsx
CACHE_KEEPALIVE_MAX_TRIES integer 1 Maximum keepalive retry attempts scorpiox-configsx
CACHE_KEEPALIVE_TRIGGER integer 270 Seconds of inactivity before sending keepalive scorpiox-configsx
CONTEXT_CLEAR_THRESHOLD integer 190000 Token count threshold to trigger context window clearing scorpiox-configsx

Spaceship 5

類型 預設 描述 使用者
SPACESHIP_API_BASE string Base URL for Spaceship API scorpiox-spaceship-clisx
SPACESHIP_API_KEY string Spaceship registrar API key scorpiox-spaceship-clisx
SPACESHIP_API_SECRET string Spaceship registrar API secret scorpiox-spaceship-clisx
SPACESHIP_DEFAULT_IP string Default IP address for Spaceship DNS records scorpiox-spaceship-clisx
SPACESHIP_DOMAIN string Domain name managed via Spaceship scorpiox-spaceship-clisx

System 6

類型 預設 描述 使用者
CURL_CA_BUNDLE string Path to CA certificate bundle for curl/TLS scorpiox-trafficsx
EXE_DIR path Directory containing scorpiox executables (auto-detected) sx
PROJECT_DIR path Project working directory override scorpiox-email
SCORPIOX_BRANCH string Git branch name passed to container environments scorpiox-sdkscorpiox-tmuxscorpiox-unshare
SCORPIOX_HOME string Base directory for scorpiox data (default: ~/.scorpiox) scorpiox-agentscorpiox-docsscorpiox-sdkscorpiox-search+4
SESSION_RETENTION_DAYS integer 7 Number of days to retain session data sx

Tools 15

類型 預設 描述 使用者
ASKUSER_TIMEOUT integer 120 Timeout in seconds for AskUserQuestion tool scorpiox-configsx
AUTO_ACCEPT_PLAN boolean 1 Automatically accept generated plans without confirmation scorpiox-configsx
TOOLS boolean 1 Enable/disable all tools globally scorpiox-busyboxscorpiox-configscorpiox-initscorpiox-mcp+1
TOOL_ASKUSERQUESTION boolean 1 Enable the AskUserQuestion tool scorpiox-configsx
TOOL_BACKGROUNDBASH boolean 1 Enable the BackgroundBash tool scorpiox-configsx
TOOL_BASH boolean 1 Enable the Bash tool scorpiox-configsx
TOOL_INVOKESKILL boolean 1 Enable the InvokeSkill tool scorpiox-configsx
TOOL_KILLBGTASK boolean 1 Enable the KillBgTask tool scorpiox-configsx
TOOL_LISTBGTASKS boolean 1 Enable the ListBgTasks tool scorpiox-configsx
TOOL_PLANMODE boolean 1 Enable the PlanMode tool scorpiox-configsx
TOOL_READBGOUTPUT boolean 1 Enable the ReadBgOutput tool scorpiox-configsx
TOOL_READDOCS boolean 1 Enable the ReadDocs tool scorpiox-configsx
TOOL_READIMAGE boolean 1 Enable the ReadImage tool scorpiox-configsx
TOOL_TASKMANAGER boolean 1 Enable the TaskManager tool scorpiox-configsx
TOOL_WEBSEARCH boolean 1 Enable the WebSearch tool scorpiox-configsx

Tui 5

類型 預設 描述 使用者
ENABLE_GRADIENT boolean 0 Enable gradient coloring in TUI scorpiox-configsx
ENABLE_TERM_BACKGROUND boolean 1 Enable terminal background color detection/override scorpiox-configsx
ENABLE_TEXT_BG boolean 1 Enable text background coloring in TUI scorpiox-configsx
ENABLE_WELCOME boolean 1 Show welcome banner on startup scorpiox-configsx
TUI_FULL_REFRESH integer 10 Seconds between full TUI screen refreshes scorpiox-configsx

Usage 4

類型 預設 描述 使用者
EMIT_SESSION_API_URL path API endpoint for session tracking data scorpiox-configscorpiox-emit-sessionsx
EMIT_SESSION_TRACKING boolean 0 Enable session emission tracking scorpiox-configscorpiox-emit-sessionsx
USAGE_API_URL path API endpoint for usage tracking data scorpiox-configscorpiox-usagesx
USAGE_TRACKING boolean 1 Enable usage/telemetry tracking scorpiox-configscorpiox-usagesx

Voice 1

類型 預設 描述 使用者
VOICE_WHISPER_URL path URL for Whisper speech-to-text API endpoint scorpiox-voicesx

Wasm 1

類型 預設 描述 使用者
WASM_API_PROXY string Proxy URL for WASM API calls scorpiox-configsx

Whatsapp 5

類型 預設 描述 使用者
WA_AUTH_DIR path .scorpiox/whatsapp/auth Directory for WhatsApp authentication data scorpiox-configscorpiox-whatsappsx
WA_BRIDGE_AUTO_UPDATE string on-demand WhatsApp bridge auto-update mode (on-demand, always, never) scorpiox-configscorpiox-whatsappsx
WA_BRIDGE_PATH path Path to WhatsApp bridge binary scorpiox-configscorpiox-whatsappsx
WA_INBOX_DIR path .scorpiox/whatsapp/inbox Directory for WhatsApp inbox messages scorpiox-configscorpiox-whatsappsx
WA_LISTEN_SESSION string Session name for WhatsApp listener scorpiox-configscorpiox-whatsappsx
No matching config keys found.