Configuration Reference

All Stackie configuration lives in a single human-readable YAML file. Every field has a sensible default, so you only need to specify the values you want to change. If you are upgrading from an older version that used settings.json, Stackie migrates your preferences automatically on first launch.

File Location

~/.stackie/stackie.yaml

Example Configuration

api:
  metrics:
    show_cpu: true
    show_memory: true

sources:
  preferences:
    macos: [brew, web, npm, pip]
    linux: [apt, web, npm, pip]
    windows: [winget, web, npm, pip]
  prefer_existing_installation: true
  latest_update_source: current

security:
  allow_custom_stacks: false
  supercache_domain: supercache.stackie.dev
  trusted_domains:
    - github.com
    - "*.github.com"

plugins:
  mcp:
    enabled: true
    port: 17374

Editing Settings

You can edit ~/.stackie/stackie.yaml directly in any text editor, or use the CLI:

# View a specific setting
stackie config get channel

# Change a setting
stackie config set channel canary