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.