Skip to content

CLI Commands

Global Options

OptionDescription
--help, -hShow help
--version, -vShow version
--print-logsPrint logs to stderr
--log-level DEBUG|INFO|WARN|ERRORSet log level
--pureDisable external plugins

Core Commands

CommandDescription
swust-codeStart the interactive TUI
swust-code run [message]Run one prompt
swust-code run --goal "goal" "message"Goal-driven run mode
swust-code dreamStart the memory consolidation command flow
swust-code distillStart the workflow packaging command flow
swust-code serveStart a headless API server
swust-code webStart the server and open the Web UI
swust-code attach <url>Attach to an existing server

run Options

bash
swust-code run [message..]

Options:
  -c, --continue          Continue the last session
  -s, --session           Continue a specific session ID
  -m, --model             Model in provider/model format
  --goal                  Set an autonomous goal
  --agent                 Select an agent
  --fork                  Fork before continuing
  --share                 Share the session
  --format default|json   Output format
  -f, --file              Attach file(s)
  --title                 Session title
  --attach                Attach to a remote server
  --dir                   Working directory
  --interactive, -i       Direct interactive mode
  --thinking              Show thinking blocks
  --variant               Provider-specific model variant

Management Commands

CommandDescription
swust-code providers listList provider credentials
swust-code providers login [url]Log in to a provider
swust-code providers logout [provider]Remove provider credentials
swust-code providers importImport credentials from MiMo-Code, Claude Code, or env vars
swust-code agentManage agents
swust-code mcp listList MCP servers
swust-code mcp addAdd an MCP server
swust-code mcp auth [name]Run OAuth for a remote MCP server
swust-code models [provider]List models
swust-code plugin <module>Install a plugin
swust-code sessionManage sessions
swust-code dbDatabase tools
swust-code statsToken and cost stats
swust-code export [sessionID]Export session JSON
swust-code import <file>Import session JSON or share URL
swust-code githubManage GitHub agent
swust-code pr <number>Checkout a PR and run SWUST Code
swust-code acpStart Agent Client Protocol server
swust-code upgradeUpgrade
swust-code uninstallUninstall