pi-git-status-line

A standalone Pi package that extends Pi's status line below the input with git information for the current working tree:

• current branch name
• amount of uncommitted files
• commits to be pushed (↑)
• commits to be pulled (↓)

It keeps Pi's existing footer/status line and adds a git summary via ctx.ui.setStatus(...).

Preview

Install

From npm

pi install npm:pi-git-status-line

From git

pi install git:github.com/qualiti/pi-git-status-line

From a local checkout

pi install /absolute/path/to/pi-git-status-line

Usage

After installation, reload Pi or start a new session.

When you are inside a git repository, the footer will show a summary like:

 main · 2 uncommitted · ↑1 ↓0

If the repo is clean:

 main · ✓ clean · ↑0 ↓0

If the branch has no upstream yet:

 feature/new-branch · 1 uncommitted · no upstream

Notes

• works only when the current working directory is inside a git repository
• refreshes on session start, after turns, and after bash, write, or edit tool executions
• if Pi is not in a git repo, the extension hides its status text

Requirements

• git must be available on PATH

Package structure

This package follows Pi package guidelines:

• it declares a pi manifest in package.json
• it exposes the extension through ./extensions
• it ships TypeScript directly so Pi can load it through jiti

Local development

Run the unit tests:

npm test

Run a local package install into Pi:

pi install /absolute/path/to/pi-git-status-line

Or load the extension file directly for quick testing:

pi -e /absolute/path/to/pi-git-status-line/extensions/git-status-line.ts

Files

• package.json — Pi package manifest for npm and git installs
• extensions/git-status-line.ts — the extension entry point
• tests/git-status-line.test.ts — helper tests