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: "en" (default)
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
language: "fr"
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rest.
{
  "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)

clock.hour12: true (12h)
🔄 Reset: 11:16pm
clock.hour12: false (24h)
🔄 Reset: 23:16
{
  "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: "countdown"
⏳ 72.0% rem │ 🔄 Reset: 2hr 47m
resetFormat: "time"
⏳ 72.0% rem │ 🔄 Reset: 11:16pm
resetFormat: "both"
⏳ 72.0% rem │ 🔄 Reset: 11:16pm (2hr 47m)
{
  "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"

Theme colors (off)
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
gradient: "aurora"
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
gradient: "sunset"
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
{
  "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
⏳ 72.0% rem
meterStyle: shade
⏳ 72.0% rem
meterStyle: pips
⏳ 72.0% rem
meterStyle: cells (Pills)
⏳ 72.0% rem
{
  "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: true (default)
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
emojis: false
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
{
  "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: false (default)
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
minimalist: true
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
{
  "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: true (default)
⏳ 72.0% rem
pacing: false
⏳ 72.0% rem
{
  "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)

Normal quota (72% rem)
⏳ 72.0% rem 💾 440.4K/1.0M (42.0%)
Caution (22% rem / 75% ctx)
⏳ 22.0% rem │ 💾 786.4K/1.0M (75.0%)
Danger (6% rem / 95% ctx)
⏳ 6.0% rem │ 💾 996.1K/1.0M (95.0%)
{
  "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: false (default)
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
72.0% rem │ 2hr 47m 21.0% rem 1d 17h
rowGap: true
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
72.0% rem │ 2hr 47m 21.0% rem 1d 17h
{
  "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: full (96 cols terminal)
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
72.0% rem │ 2hr 47m 21.0% rem 1d 17h
maxWidth: 72 cols cap
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main
72.0% rem │ 2hr 47m 21.0% rem 1d 17h
{
  "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: "left"
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
alignment: "center"
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
alignment: "spread"
🤖 Gemini 4 Hydrogen (High) 💾 149.3K/1.0M (14.2%) 🌿 ● main
{
  "alignment": "center"
}

Quota display quotaMode

Displays quota meters and percentages as remaining capacity (rem) or consumed usage (used).

Default: "remaining" · Options: remaining, used

quotaMode: "remaining"
⏳ 72.0% rem 📅 21.0% rem
quotaMode: "used"
⏳ 28.0% used 📅 79.0% 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: false (default)
🧪 3P 5h: 100.0% rem 🧪 3P 7d: 0.0% rem
zeroFiveHourWhenWeeklyEmpty: true
🧪 3P 5h: 0.0% rem │ 🧪 3P 7d: 0.0% rem
{
  "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: "fit" (54 cols)
4 Hydrogen·High
72.0% rem 21.0% rem
overflow: "wrap" (54 cols)
🤖 Gemini 4 Hydrogen (High)
💾 149.3K/1.0M (14.2%) 🌿 ● main
⏳ 72.0% rem │ 🔄 Reset: 2hr 47m
📅 21.0% rem 🔄 Reset: 1d 17h
{
  "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: false (default)
4 Hydrogen·High 149.3K/1.0M (14.2%) ● main 72.0% rem
ascii: true
[ 4 Hydrogen High > [ ] 149.3K/1.0M (14.2%) > * main > [ | ] 72.0% rem ]
{
  "ascii": true
}

Next steps