station-config by cloudshipai

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

```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_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

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

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

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