pi-echo-git-status
Footer indicator showing the current git branch and dirty/clean state
Package details
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.