Configuration System

Red Station uses a hierarchical configuration system that gives you Global consistency while allowing for Project-Level flexibility.

Hierarchy

When settings are resolved, Red Station looks in the following order (highest priority first):

1. CLI Flags (--model gpt-4)
2. Environment Variables (PILOT_MODEL=gpt-4)
3. Project Config (./.pilot/config.yaml)
4. Global Config (~/.pilot/config.yaml)
5. Defaults (Built-in software defaults)

Global (~/.pilot/)

Contains your "user profile" for the platform.

• config.yaml: User preferences (theme, default autonomy).
• secrets.yaml: API keys.
• models.yaml: LLM provider setups.
• agent-defaults.yaml: Baseline security settings for all agents.

Project (./.pilot/)

Contains team-shared settings. Commit this to Git.

• config.yaml: Project-specific overrides (e.g., "Always use smart model for this repo").
• policies/: Governance rules specific to this repo.

CLI Commands

See CLI Reference for full command details.

# View aggregated configuration
pilot config show

# Open global config
pilot config edit

# Reset to defaults
pilot config reset