pi-echo-git-status

Footer indicator showing the current git branch and dirty/clean state

Packages

Package details

extension

Install pi-echo-git-status from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-echo-git-status
Package
pi-echo-git-status
Version
0.1.0
Published
Aug 13, 2026
Downloads
154/mo · 8/wk
Author
hegdesumanth.dev
License
unknown
Types
extension
Size
4.1 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "."
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-echo-git-status

A footer indicator showing the current git branch and dirty/clean state (✓ main or ● feature-branch).

Design note

Uses pi.exec() with a single combined git status --porcelain=v1 --branch call rather than two separate git invocations — one command's ## branch... header line plus its file-status lines give both branch name and dirty state together. Outside a git repository, or if git isn't on PATH, this degrades to showing nothing at all, not an error — the same graceful-degradation precedent pi-echo-checkpoints already established for exactly this situation. Refreshed on session_start and after every turn_end, matching pi-echo-statusline's cadence.

Found via testing against real git status --porcelain --branch output, not assumed: a detached HEAD reports its branch header literally as ## HEAD (no branch) — without special-casing it, the indicator would show ✓ HEAD, which reads as a bug rather than a state. Fixed to show detached instead. Verified the fix against real output for a dirty branch, a clean branch with remote-tracking info (main...origin/main), an ahead/behind branch, and the detached case.

Usage

No configuration — install it and the indicator just appears in the footer whenever the current directory is inside a git repository.