Skip to main content
>_ Command Reference

Command Reference

Everything you can do inside the Snow-Flow TUI and from the command line. The TUI is your primary workspace — most developers never leave it.

TUI Slash Commands

Type these commands directly inside the TUI input field. They are the fastest way to navigate, configure, and control Snow-Flow while you work.

Sessions

/new, /clear Start a new session
/sessions, /resume List and resume sessions
/timeline, /history Show session timeline

Models & Agents

/models List and select AI models
/agents List available agents

Sharing & Export

/share Share current session
/unshare Stop sharing session
/export Export conversation

Editing & History

/compact, /summarize Compact session history
/editor Open external editor
/undo Undo last message
/redo Redo message

Configuration & Display

/themes Switch color theme
/init Create/update AGENTS.md
/details Toggle tool details view
/thinking Toggle thinking blocks

System

/help Show available commands
/auth, /login Authenticate with providers
/debug Toggle debug mode
/exit, /quit, /q Exit application
i All slash commands work while the AI is idle. Some commands like /compact and /undo affect the current session's message history.

Starting Snow-Flow

Launch the TUI from your terminal. Once inside, you interact entirely through the interface — no need to drop back to your shell.

TERMINAL
# Launch the TUI
$ snow-flow

# Start with a specific model
$ snow-flow --model anthropic/claude-sonnet-4

# Continue where you left off
$ snow-flow --continue

# Start in planning mode
$ snow-flow --agent plan
snow-flow Launch the TUI
Usage: snow-flow [project]

Options

--model, -m Start with a specific AI model
--continue, -c Continue the most recent session
--session, -s Resume a specific session by ID
--agent Start with a specific agent (build, plan)
--prompt Send an initial prompt on start

Additional CLI Commands

These commands run outside the TUI. Useful for scripting, CI/CD pipelines, and automation.

snow-flow run Run a single prompt without the TUI
Usage: snow-flow run [message..]

Options

--model, -m Model to use
--agent Agent mode
--continue, -c Continue the most recent session
--format Output format: default, json
--file, -f Read prompt from file
--attach Attach file to the prompt
--share Share session after completion

Examples

snow-flow run "Create a new incident widget"snow-flow run --format json "List all tables"
snow-flow serve Start the headless API server
Usage: snow-flow serve

Options

--port Port to listen on (default: 4096)
--hostname Hostname to bind to
--cors Enable CORS headers

Examples

snow-flow servesnow-flow serve --port 4096
snow-flow web Start server and open web interface
Usage: snow-flow web

Options

--port Port to listen on

Examples

snow-flow websnow-flow web --port 8080
snow-flow auth Authentication management
Usage: snow-flow auth <action>

Subcommands

login [url] Authenticate with providers and ServiceNow
logout Clear authentication tokens
list Show configured authentication

Examples

snow-flow auth loginsnow-flow auth login https://dev12345.service-now.comsnow-flow auth list
snow-flow session Session management
Usage: snow-flow session <action>

Subcommands

list List all sessions

Options

--format Output format: table, json

Examples

snow-flow session listsnow-flow session list --format json
snow-flow models List available AI models
Usage: snow-flow models [provider]

Options

--verbose Show detailed model information
--refresh Refresh cached model list

Examples

snow-flow modelssnow-flow models anthropic
snow-flow mcp MCP server management
Usage: snow-flow mcp <action>

Subcommands

add Add MCP server to configuration
list List configured MCP servers
auth <name> Authenticate with an MCP server
debug <name> Debug an MCP server connection

Examples

snow-flow mcp addsnow-flow mcp listsnow-flow mcp auth servicenow
snow-flow upgrade Upgrade to the latest version
Usage: snow-flow upgrade [target]

Options

--method, -m Install method: curl, npm, bun, brew

Examples

snow-flow upgradesnow-flow upgrade --method brew

Global Options

Available on all CLI commands:

--help, -h Show help for any command
--version, -v Show current version
--print-logs Print log file path on exit
--log-level Set log level: DEBUG, INFO, WARN, ERROR

Environment Variables

SNOWCODE_SERVER Custom server URL
OPENCODE_SERVER_PASSWORD Secure the headless server with a password
OPENCODE_THEME Theme override
SERVICENOW_INSTANCE ServiceNow instance URL
SERVICENOW_CLIENT_ID OAuth Client ID
SERVICENOW_CLIENT_SECRET OAuth Client Secret
ANTHROPIC_API_KEY Anthropic API key for Claude
OPENAI_API_KEY OpenAI API key

Ready to dive deeper?

Learn keyboard shortcuts and agent modes in the TUI Guide, or get up and running with the Quick Start.