// configuration

Configuration

Full YAML configuration reference.

Config File Location

The configuration file is located at:

~/.claude-statusline/config.yml

Full Example

yaml

# Language: en | fr
locale: "en"

# Theme: default | minimal | neon | dracula | catppuccin | nord
theme: "default"

# Lines configuration
lines:
  - widgets: [model, separator, directory, separator, git-branch, separator, duration, separator, cost]
  - widgets: [token-bar, context-percent, token-count]
  - widgets: []

# Widget options
widgets:
  cost:
    currency: "USD"
    decimals: 2
  token_bar:
    width: 16
    filled_char: "━"
    empty_char: "─"
  separator:
    char: "│"
  model:
    short_name: false
  timestamp:
    show_seconds: false

# Color thresholds
thresholds:
  context:
    green: 0
    yellow: 50
    orange: 70
    red: 90
  cost:
    green: 0
    yellow: 0.25
    orange: 1.0
    red: 5.0
  duration:
    green: 0
    yellow: 60
    red: 1800

Locale

Set the display language. Available: en, fr.

yaml

# Language: en | fr
locale: "fr"

Theme

Set the visual theme. Available: default, minimal, neon, dracula, catppuccin, nord.

yaml

# Theme: default | minimal | neon | dracula | catppuccin | nord
theme: "dracula"

Lines Configuration

Configure up to 3 lines with any combination of widgets.

yaml

lines:
  - widgets: [model, separator, directory, separator, git-branch]
  - widgets: [token-bar, context-percent, cost]
  - widgets: [duration, separator, lines-changed]

Widget Options

Fine-tune individual widget behavior.

yaml

widgets:
  cost:
    currency: "EUR"    # Currency code
    decimals: 2        # Decimal places
  token_bar:
    width: 16          # Bar character width
    filled_char: "━"   # Filled portion
    empty_char: "─"    # Empty portion
  separator:
    char: "│"          # Separator character
  model:
    short_name: false  # Use short model names
  timestamp:
    show_seconds: false

Color Thresholds

Set color-coded thresholds for dynamic widgets.

yaml

thresholds:
  context:            # Context window usage
    green: 0          # 0-49%
    yellow: 50        # 50-69%
    orange: 70        # 70-89%
    red: 90           # 90-100%
  cost:               # Session cost
    green: 0          # $0-$0.24
    yellow: 0.25      # $0.25-$0.99
    orange: 1.0       # $1.00-$4.99
    red: 5.0          # $5.00+
  duration:           # Session duration (seconds)
    green: 0          # 0-59s
    yellow: 60        # 1m-29m
    red: 1800         # 30m+