| name | station-config |
| description | Configure Station CLI settings via browser UI or command line. Use `stn config --browser` for visual editor or `stn config set/show` for CLI operations. |
Station Configuration
Configure Station settings including AI provider, coding backend, CloudShip integration, and more.
Browser-Based Configuration (Recommended)
The easiest way to configure Station is via the browser UI:
# Opens browser-based config editor
# Automatically starts server if not running
stn config --browser
This opens a visual editor with:
- All configuration sections organized
- Conditional fields (e.g., backend-specific settings only show for selected backend)
- Secret fields with show/hide toggle
- Validation and defaults
CLI Configuration Commands
View Configuration
# Show all config (secrets redacted)
stn config show
# Show specific section
stn config show ai
stn config show coding
stn config show cloudship
# Show config file path
stn config path
# Show all available config keys
stn config schema
Set Configuration Values
# Set a value
stn config set <key> <value>
# Examples
stn config set ai_provider anthropic
stn config set ai_model claude-sonnet-4-20250514
stn config set coding.backend opencode
stn config set cloudship.enabled true
# Set nested values
stn config set coding.nats.url nats://localhost:4222
stn config set cloudship.api_key cst_xxx
# Reset to default
stn config reset <key>
Edit Config File Directly
# Open in $EDITOR
stn config edit
Configuration Sections
AI Provider (ai_*)
| Key | Description | Default |
|---|---|---|
ai_provider |
Provider: openai, anthropic, ollama, gemini | openai |
ai_model |
Model name | gpt-4o |
ai_api_key |
API key (secret) | - |
ai_base_url |
Custom base URL for OpenAI-compatible | - |
Coding Backend (coding.*)
| Key | Description | Default |
|---|---|---|
coding.backend |
Backend: opencode, opencode-nats, opencode-cli, claudecode | opencode-cli |
coding.workspace_base_path |
Base path for workspaces | /tmp/station-coding |
coding.max_attempts |
Max retry attempts | 3 |
coding.task_timeout_min |
Task timeout in minutes | 30 |
Backend-specific settings:
For opencode:
coding.opencode.url- OpenCode HTTP server URL
For opencode-nats:
coding.nats.url- NATS server URLcoding.nats.subjects.task- Task subjectcoding.nats.subjects.result- Result subjectcoding.nats.subjects.stream- Stream subject
For opencode-cli:
coding.cli.binary_path- Path to opencode binarycoding.cli.timeout_sec- CLI timeout
For claudecode:
coding.claudecode.binary_path- Path to claude binarycoding.claudecode.timeout_sec- Timeoutcoding.claudecode.model- Model: sonnet, opus, haikucoding.claudecode.max_turns- Max conversation turnscoding.claudecode.allowed_tools- Tool whitelistcoding.claudecode.disallowed_tools- Tool blacklist
CloudShip Integration (cloudship.*)
| Key | Description | Default |
|---|---|---|
cloudship.enabled |
Enable CloudShip | false |
cloudship.api_key |
Personal API key (cst_...) | - |
cloudship.registration_key |
Station registration key | - |
cloudship.endpoint |
Lighthouse gRPC endpoint | lighthouse.cloudshipai.com:443 |
cloudship.use_tls |
Use TLS | true |
cloudship.name |
Station name (unique) | - |
cloudship.tags |
Tags for filtering | - |
Server Settings (api_port, mcp_port, etc.)
| Key | Description | Default |
|---|---|---|
api_port |
API server port | 8585 |
mcp_port |
MCP server port | 8586 |
debug |
Debug mode | false |
workspace |
Custom workspace path | - |
Other Sections
- Telemetry (
telemetry.*) - Tracing/observability settings - Sandbox (
sandbox.*) - Code execution sandbox settings - Webhook (
webhook.*) - Webhook endpoint settings - Notifications (
notifications.*,notify.*) - Alert/notification settings
Common Workflows
Initial Setup
# Configure AI provider
stn config set ai_provider anthropic
stn config set ai_model claude-sonnet-4-20250514
# Or use browser for full setup
stn config --browser
Connect to CloudShip
stn config set cloudship.enabled true
stn config set cloudship.api_key cst_your_api_key
stn config set cloudship.registration_key your_reg_key
stn config set cloudship.name my-station
Change Coding Backend
# Switch to OpenCode with NATS
stn config set coding.backend opencode-nats
stn config set coding.nats.url nats://localhost:4222
# Or use Claude Code
stn config set coding.backend claudecode
stn config set coding.claudecode.model opus
Config File Location
Default: ~/.config/station/config.yaml
Override with --config flag or STN_CONFIG environment variable.