# agy statusline settings

## language
Translates labels, time units, and captions rendered inside the bar while keeping payload values intact.
- Default: `"en"`
- Options: en, fr, es, ja, zh-CN, ko, de

## clock.hour12
Controls 12-hour vs 24-hour formatting for exact reset timestamps and the clock widget.
- Default: `null (auto)`
- Options: null (auto locale), false (24h), true (12h)

## resetFormat
Sets the global default for reset countdown widgets unless overridden per widget with format.
- Default: `"countdown"`
- Options: countdown, time, both

## gradient
Sweeps one smooth color gradient across all pills on each row instead of per-widget slot colors.
- Default: `off (unset)`
- Options: off, aurora, sunset, ocean, forest, neon, candy, rainbow, mono, or "#hex1-#hex2"

## meterStyle
Overrides the meter glyph shape globally across quota and context widgets. Per-widget meter options still win.
- Default: `layout default`
- Options: pips, cells, dots, blocks, shade, squares, braille, rings, ramp

## emojis
Shows or hides widget icons globally across the bar. Disabled automatically while ascii is true.
- Default: `true`
- Options: true, false

## minimalist
Displays raw values only while hiding labels and icons unless a widget explicitly configures a label.
- Default: `false`
- Options: false, true

## pacing
Draws the elapsed-window marker inside quota meters so you can see whether usage outpaces the clock.
- Default: `true`
- Options: true, false

## thresholds
Sets caution and danger color breakpoints for quotas and context, plus optional ANSI blink alerts.
- Default: `quota 30%/10%, context 70%/90%, blink false`
- Options: quotaWarn, quotaCrit, contextWarn, contextCrit (0-100); blink: false (off), true (danger), "warn" (caution + danger)

## rowGap
Inserts a blank line between statusline rows so multi-row Pills or Lines layouts breathe cleanly.
- Default: `false`
- Options: false, true

## maxWidth
Caps bar width on wide monitors instead of stretching separators across the full terminal width.
- Default: `null ("full")`
- Options: "full" / null, or positive integer columns (1..1000)

## alignment
Positions widgets horizontally on each row: left-aligned with explicit separators, centered, or evenly spread.
- Default: `"left"`
- Options: left, center, spread

## quotaMode
Displays quota meters and percentages as remaining capacity (rem) or consumed usage (used).
- Default: `"remaining"`
- Options: remaining, used

## zeroFiveHourWhenWeeklyEmpty
Shows 0% remaining (100% used) on all 5-hour quota widgets whenever the matching 7-day quota is at 0%, even when Antigravity marks 3p-5h disabled.
- Default: `false`
- Options: false, true

## overflow
Decides what happens on narrow terminals: fit shrinks labels and drops lower-priority items, while wrap keeps everything onto new rows.
- Default: `"fit"`
- Options: fit, wrap

## ascii
Replaces Nerd Font powerline caps, emojis, and Unicode box/meter glyphs with plain ASCII characters.
- Default: `false`
- Options: false, true
