pi-posh-git
posh-git style persistent git status for pi. Displays branch, ahead/behind, staged/unstaged counts, and stash count — always visible in the footer.
Package details
Install pi-posh-git from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-posh-git- Package
pi-posh-git- Version
1.1.2- Published
- May 4, 2026
- Downloads
- 109/mo · 109/wk
- Author
- ngsoftware
- License
- MIT
- Types
- extension
- Size
- 18.7 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
],
"image": "https://raw.githubusercontent.com/pungggi/pi-posh-git/master/screenshot.png"
}
Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-posh-git
A posh-git style persistent git status footer for pi.
Displays branch, ahead/behind, staged/unstaged counts, and stash count — always visible on the right side of the pwd line in the footer. Replaces pi's built-in footer branch display to avoid duplication. No commands needed.
Install
pi install npm:pi-posh-git
Or add manually to your pi settings.json:
{
"packages": ["npm:pi-posh-git"]
}
What it looks like
Git status appears on the right side of the pwd line in the footer:
~/projects/app [main ↑3 +1 ~0 -0 | +0 ~2 -0 !]
| Element | Symbol | Meaning |
|---|---|---|
| Brackets | [ ] |
Yellow |
| Branch | main |
Cyan/accent |
| Identical | ≡ |
Up to date with remote |
| Ahead | ↑3 |
3 commits ahead |
| Behind | ↓2 |
2 commits behind |
| Diverged | ↓2 ↑3 |
Behind & ahead |
| Gone | × |
Upstream deleted |
| Staged | +1 ~2 -0 |
Green (index changes) |
| Delimiter | | |
Yellow separator |
| Unstaged | +0 ~1 -0 |
Red (working tree) |
| Clean | ≡ |
Green |
| Staged only | ~ |
Cyan |
| Dirty | ! |
Red |
| Stash | (3) |
Stash count |
Auto-refreshes on session start and after every tool execution.
Footer integration
The extension replaces pi's built-in footer with a custom one that shows the same information (pwd, token stats, context usage, model name) with the git status appended to the right side of the pwd line. The built-in footer is automatically restored when the session shuts down.
Requirements
- pi coding agent
- Git installed and available in
PATH - Node.js ≥ 20
License
MIT