CLI Commands
TAU CLI reference for all available commands and options.
Basic Usage
# Start TUI (default)
tau
# Run with specific model
tau --model anthropic/claude-sonnet-4-5
# Run in specific directory
tau --directory /path/to/project
# Run single query (non-interactive)
tau run "Explain this codebase"
Core Commands
| Command | Description |
|---|
| tau | Start TUI interface (default) |
| tau run "query" | Run single query and exit |
| tau serve | Start HTTP/SSE server |
| tau web | Start web interface |
| tau attach | Attach to running server |
MCP Commands
# List available tools
tau mcp tools
# Call a tool
tau mcp call read --file_path ./src/main.rs
# Install MCP server
tau mcp install browser
tau mcp install slack
# Server management
tau mcp status
tau mcp restart brave-search
tau mcp debug filesystem
Model Commands
# List configured providers and models
tau models list
# List models from specific provider
tau models list --provider anthropic
# Verbose output with pricing
tau models list --verbose
# Refresh models.dev cache
tau models refresh
# Test provider connectivity
tau models test anthropic
Session Commands
# List sessions
tau sessions list
# Show session history
tau sessions show <session-id>
# Export session
tau sessions export <session-id> --format json
# Delete session
tau sessions delete <session-id>
# Resume session
tau sessions resume <session-id>
History Commands
# Show conversation history
tau history
# Show with costs
tau history --costs
# Show last N messages
tau history --limit 10
# Clear history
tau history clear
Index Commands
# Index current project
tau index
# Index specific directory
tau index /path/to/project
# Force re-index
tau index --force
# Index with semantic vectors
tau index --semantic
# Restart file watcher
tau index --watch-restart
# Check index status
tau index status
Auth Commands
# OAuth login
tau auth login github-copilot
tau auth login anthropic
# Store API key in keyring
tau auth set anthropic
tau auth set openai
# List stored credentials
tau auth list
# Remove credential
tau auth remove anthropic
# Verify authentication
tau auth verify anthropic
Import Commands
# Import from OpenCode
tau import --from opencode
# Import specific components
tau import --from opencode --only sessions
tau import --from opencode --only config
GitHub Commands
# Install GitHub Actions workflow
tau github install
# Run as GitHub Actions agent
tau github run
# Checkout PR
tau pr checkout 123
Global Options
| Option | Description |
|---|
| --model, -m | Specify model (provider/model-name) |
| --provider, -p | Specify provider |
| --directory, -d | Working directory |
| --log-level | Set log level (trace, debug, info, warn, error) |
| --print-logs | Print logs to stderr |
| --config | Custom config file path |
| --version, -V | Show version |
| --help, -h | Show help |
Examples
# Start TUI with Claude Opus
tau --model anthropic/claude-opus-4-5
# Run query with GPT-5
tau run --model openai/gpt-5 "Explain async in Rust"
# Start server on custom port
tau serve --port 8080
# Index with debug logging
tau index --log-level debug
# Import OpenCode sessions
tau import --from opencode
# List all Anthropic models
tau models list --provider anthropic --verbose