station-config

# 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:

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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_attemp