Status line
Extension
Shows ready, running, and completed turn states in Pi’s themed footer.
What it does
Status line writes themed Ready, in-progress, and completed-turn messages to Pi's footer as session and turn events arrive.
It keeps a process-local turn count, increments it at each turn start, and resets it when a session switch reports a new session.
When to reach for it
Invocation: Load the local extension in an interactive Pi session; its event hooks update the status entry automatically.
- You want a glanceable signal that an interactive turn has started or ended
- Watch the accent dot while work is in progress and the success check when the turn completes.
- You want a lightweight turn number in the footer
- Read the in-memory count shown in the running and completed messages.
What it adds
- One footer status entry under the fixed status-demo key.
- Theme-aware dim text, an accent running marker, and a success completion marker.
How it fits
- Mac system theme: Status line uses Pi's themed colors; Mac system theme can select the active light or dark palette.
Common questions
- What should not be treated as durable state?
- The counter lives in the extension process and every update uses the same status-demo key. A session-start event displays Ready without resetting the count; only a session switch whose reason is new resets it. Treat this as a compact activity indicator, not durable telemetry.
- Does every session switch change the display?
- No. The session-switch handler does nothing unless the event reason is new.
It’s working if
- A session-start event displays dim Ready in the status entry.
- Each turn start shows an accent dot and incremented turn number; the matching turn end shows a success check and complete text for that number.
Source and setup
Provenance
- Project
- Status line
- Origin
- Mario Zechner
- Current maintainer
- Vedang Manerikar
- Relationship
- adopted
- Installed source
pi-extensions/status-line.ts- Source path
- View source (
pi-extensions/status-line.ts) - Compatibility
- Interactive Pi status and theme APIs
- License
- MIT
- License publication scope
- Independently written catalog summary plus source link and upstream attribution; retain MIT attribution.
- Reviewed revision
9a0af933d90ad9175eca0ff27db6624c5d6bb4fe- Catalog revision
e0c035a297462c519315abfa1af31a1ed3bd9eef
Setup notes
- Adopted from the MIT-licensed Pi example originally authored by Mario Zechner; Vedang maintains this local copy.
- The installed source is the local Status line extension.
- It needs an interactive Pi UI that exposes status and theme APIs.
- Behavior claims were reviewed against the project's pinned Dotagents revision.