sx Core

A full-featured terminal user interface for interacting with Claude AI. Supports multiple providers, headless mode, session management, and cross-platform operation.

Linux x64 Linux ARM64 macOS ARM64 Windows x64

Flags & Options

Flag Short Description Value
--cwd-cSet working directoryYes
--dry-runPreview actions without executingNo
--emit-bindingsEmit bindings to stdout (LANG: cs, swift, c)Yes
--emit-session-eEmit current session data to stdoutNo
--headlessRun without TUI (non-interactive / CI mode)No
--helpShow help informationYes
--host-hConnect to host endpointYes
--new-nStart a new conversationNo
--promptSend an initial prompt on launchYes
--provider-pProvider: scorpiox, claude_code, gemini, openai, anthropicYes
--session-idResume a specific session by IDYes
--version-vPrint version and exitNo
-mSend a message directly (non-interactive)Yes

Usage Examples

# Launch the TUI — starts a new interactive conversation
sx
# Start a fresh conversation explicitly
sx --new
# Send a one-shot message without entering the TUI
sx -m "Explain the difference between TCP and UDP"
# Launch with a prompt that auto-submits on start
sx --prompt "Review this codebase for security issues"
# Set working directory for file operations
sx --cwd ~/projects/my-app
# Use a specific AI provider
sx --provider openai
sx -p anthropic
# Connect to a remote ScorpioX host
sx --host wss://my-server.example.com:8443
# Resume a previous session
sx --session-id a1b2c3d4-e5f6-7890-abcd-ef1234567890
# Run headless for CI/CD pipelines
sx --headless --prompt "Generate unit tests for src/auth.py"
# Pipe input in headless mode
echo "Refactor this function" | sx --headless
# Generate language bindings
sx --emit-bindings swift > SXBindings.swift
sx --emit-bindings cs > SXBindings.cs
# Export the current session for inspection or replay
sx --emit-session > session_dump.json
# Preview what would happen without executing
sx --dry-run --prompt "Delete all .tmp files in /var/log"
# Check version
sx --version

Source & Build Info

Source File
scorpiox/sx.c
Lines of Code
5,360
Category
Core
Dependencies
libsxterm libsxui libsxnet libsxutil

Related Tools