pi-statusline

Adaptive, provider-aware footer (statusline) for the Pi Coding Agent.

v2 renders a multi-line Editorial Dashboard: an identity line, a context line with bar + tokens, a money line, a provider quota line, a deen prayer line, and an ambient line. For z.ai (GLM Coding Plan) the quota line shows the authoritative 5h + weekly credit balance polled from the console API (/quota/limit); spend across all providers accumulates in a local ledger; the deen line tracks the five daily prayers with a live next-prayer countdown.

Render preview

v2-p1 pi-statusline ⎇ main | glm-5.2
ctx ▕███░░░░░░░▏ 34% 68k/200k | ↑48k ↓6.2k | cache 68%
REPO $12.34 | $1.24 sess | $8.40 day | $31.20 7d | $118.75 30d ▁▁▂▄▂▁▇ | $0.39/hr
zai ▕████████░░▏ 75% 1.5k/2.0k 5h | wk 15% | reset 2h55m
deen Fajr 05:00 ✓ | Dhuhr 12:00 (2h) | Asr 15:30 | Maghrib 18:00 | Isha 19:30 | 17 Rabīʿ al-awwal 1448 | Jakarta
04:12 | coding 3h12m

Color semantics (theme-integrated hues): money values + sparkline success (green), git branch and token flow toolTitle (blue), model + bar fills accent (escalating to warning/error at ≥70%/≥90%), quota row tints by usage heat (same bands); values text; labels/separators dim; ambient row fully dim. Separator is |. The deen strip escalates by proximity to the next prayer — calm names dim, times text, past prayers ✓ success, hijri + city muted, stale marker warning — intensifying to accent as the next prayer approaches (see Deen).

Install

In ~/.pi/agent/settings.json:

{ "packages": ["@getpipher/pi-statusline"] }

Config

~/.pi/agent/pi-statusline.json (schema v2):

{
  "enabled": true,
  "zai": { "tier": "auto", "pollIntervalMs": 180000 },
  "deen": { "city": "Jakarta", "country": "Indonesia", "method": "auto", "escalateMinutes": 30 },
  "display": {
    "rows": ["identity", "ctx", "money", "quota", "deen", "ambient"],
    "bars": true,
    "sparkline": true
  }
}

• display.rows — which rows render and in what order; a subset/reorder of the registry (identity, ctx, money, quota, deen, ambient), never an invention. Unknown ids are dropped with a one-time warning (surfaced as a notify, once per id per session — handy for typo-spotting).
• display.bars — gates the ctx row's progress bar.
• display.sparkline — gates the 7-day sparkline in the money line.
• deen — prayer-tracker settings (see Deen below). city may be "auto" for IP-based geolocation; method is the aladhan calculation method ("auto" = aladhan default); escalateMinutes sets how early the strip starts brightening (default 30).
• Back-compat: v1 config files load cleanly — the v1 showTokens / showContext / showGit / showSession flags are still honored where the merged rows allow, and a file without rows gets the full default order. A file without a deen section gets the defaults (Jakarta / Indonesia / auto / 30) — the row renders once data is fetched.

Ledger

Spend is accumulated in ~/.pi/agent/pi-statusline/ledger.jsonl — an append-only JSONL file keyed by session-entry id (restart-safe; the same entry is never counted twice). Since v0.3.0 each line records the repo it was spent in (the cwd basename at write time), and the money line leads with REPO $X — the all-time total for the current repo (once the repo has recorded any spend; a fresh ledger renders without the lead). Pre-v0.3.0 lines (no repo field, "unknown") never count toward the REPO total; per-repo history is simply not reconstructible for them. $ is folded into each money value ($1.24 sess), CC-style; with fewer than two usage entries there is no burn rate yet and the row ends | — instead. It is safe to delete at any time: the footer rebuilds from an empty ledger and historical sessions are not re-scanned — day/7d/ 30d totals simply start over from the next session.

Deen

The deen line tracks the five daily prayers (Fajr → Isha) in the city's timezone with a live countdown to the next prayer, the Hijri date, and the city. Data comes from the aladhan timingsByCity API (one call per local day), cached 24h at ~/.pi/agent/pi-statusline/deen-cache.json; when a fetch fails the last-good timetable is served with a stale Nm marker. Past prayers carry ✓; the started prayer is marked · adhan.

With city: "auto", the city is resolved once via IP geolocation (ipwho.is, cached 7 days alongside the timetable). Location is set with /statusline deen <city|auto> — persisted, and the strip is force-refreshed immediately.

The strip escalates as the next prayer approaches (minutes until next, after the countdown floors):

Band	Trigger	Rendering
calm	> escalateMinutes	names dim, times text
soon	≤ escalateMinutes	names brighten to text
near	≤ 10	next name + countdown accent
imminent	≤ 2	the whole strip accent
adhan	prayer started (≤ 0, > −10)	started prayer accent + · adhan

Commands

• /statusline refresh — force a quota poll now
• /statusline on / /statusline off — enable/disable; off restores pi's native footer until on
• /statusline tier <auto|lite|pro|max> — tier override
• /statusline deen <city|auto> — set the prayer location; persists to config and force-refreshes

Arguments are lenient: case-insensitive, surrounding whitespace tolerated, and trailing extra arguments are ignored.