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_*)

Coding Backend (coding.*)

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.*)

Server Settings (apiport, mcpport, etc.)

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.