/station-config

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 URL
• `coding.nats.subjects.task` - Task subject
• `coding.nats.subjects.result` - Result subject
• `coding.nats.subjects.stream` - Stream subject

For `opencode-cli`:

• `coding.cli.binary_path` - Path to opencode binary
• `coding.cli.timeout_sec` - CLI timeout

For `claudecode`:

• `coding.claudecode.binary_path` - Path to claude binary
• `coding.claudecode.timeout_sec` - Timeout
• `coding.claudecode.model` - Model: sonnet, opus, haiku
• `coding.claudecode.max_turns` - Max conversation turns
• `coding.claudecode.allowed_tools` - Tool whitelist
• `coding.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.