Main TUI terminal client for scorpiox AI coding sessions
sx is the primary entry point for ScorpioX Code — a fully-featured TUI (terminal user interface) client that connects you to AI-powered coding sessions directly from your terminal. It launches an interactive pair-programming environment where you can write, refactor, debug, and deploy code with AI assistance.
The client manages session state, streams AI responses in real time, renders a rich terminal UI with syntax highlighting, and supports multiple AI provider backends including Claude, Codex, and Gemini. Written in C for maximum performance and minimal startup latency.
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--version | -v | Print version information and exit | Yes |
--prompt | -p | Send a one-shot prompt without entering interactive mode | Yes |
--help | -h | Show help message and usage information | No |
--dry-run | -n | Simulate the session without making changes | Yes |
--provider | — | Select the AI provider backend (e.g. claude_code, codex, gemini) | Yes |
--new | — | Start a brand-new session with an optional name | Yes |
--cwd | — | Set the working directory for the session | Yes |
--host | — | Connect to a remote scorpiox-server host | Yes |
--headless | — | Run in headless mode (no TUI, stdout only) | No |
--session-id | — | Resume an existing session by its ID | Yes |
--emit-session | — | Write the session ID to a file on startup | Yes |
--emit-bindings | — | Export key-bindings configuration to a file | Yes |
--not-yolo | — | Disable auto-approve mode; require confirmation for every action | No |
--safe | — | Enable safe mode — block all file-write and shell operations | No |
sx
sx -p "refactor the auth module to use JWT tokens"
sx --new "backend-rewrite" --provider claude_code
sx --session-id abc123-def456
sx --dry-run -p "migrate database schema to v3"
sx --safe -p "explain the architecture of this project"
# Run sx non-interactively, pipe output to a log file
sx --headless -p "run all tests and fix failures" > ci-output.log 2>&1
sx --host dev.internal:8080 --cwd /opt/myproject
sx --not-yolo -p "delete all unused imports across the codebase"
# Save session ID so other tools can join the same session sx --emit-session /tmp/sid.txt --new "deploy-prep" # Later, in another terminal: scorpiox-transcript --session-id $(cat /tmp/sid.txt)