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.