agy statusline settings
Every bar-wide option in statusline.config.json and the CLI Settings tab. Every bar below is rendered by the real statusline code from sample data. Try them interactively in the browser configurator.
Bar language 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
{
"language": "fr"
}
Clock format 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": "time",
"clock": { "hour12": false }
}
Reset format resetFormat
Sets the global default for reset countdown widgets unless overridden per widget with format.
Default: "countdown" · Options: countdown, time, both
{
"resetFormat": "both"
}
Bar gradient 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"
{
"gradient": "sunset"
}
Meter style 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
{
"meterStyle": "blocks"
}
Emojis emojis
Shows or hides widget icons globally across the bar. Disabled automatically while ascii is true.
Default: true · Options: true, false
{
"emojis": false
}
Minimalist mode minimalist
Displays raw values only while hiding labels and icons unless a widget explicitly configures a label.
Default: false · Options: false, true
{
"minimalist": true
}
Quota pace marker pacing
Draws the elapsed-window marker inside quota meters so you can see whether usage outpaces the clock.
Default: true · Options: true, false
{
"pacing": false
}
Warning sensitivity & alert blink 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)
{
"thresholds": {
"quotaWarn": 40,
"quotaCrit": 20,
"contextWarn": 60,
"contextCrit": 80,
"blink": "warn"
}
}
Space between rows rowGap
Inserts a blank line between statusline rows so multi-row Pills or Lines layouts breathe cleanly.
Default: false · Options: false, true
{
"rowGap": true
}
Max bar width 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)
{
"maxWidth": 72
}
Row alignment alignment
Positions widgets horizontally on each row: left-aligned with explicit separators, centered, or evenly spread.
Default: "left" · Options: left, center, spread
{
"alignment": "center"
}
Quota display quotaMode
Displays quota meters and percentages as remaining capacity (rem) or consumed usage (used).
Default: "remaining" · Options: remaining, used
{
"quotaMode": "used"
}
Zero 5h when 7d is 0% 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
{
"zeroFiveHourWhenWeeklyEmpty": true
}
Row overflow 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
{
"overflow": "wrap"
}
ASCII mode ascii
Replaces Nerd Font powerline caps, emojis, and Unicode box/meter glyphs with plain ASCII characters.
Default: false · Options: false, true
{
"ascii": true
}