pi-branch-status

Persistent Git branch, pull request, mergeability, and CI status for Pi

Packages

Package details

extension

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

npm report
$ pi install npm:pi-branch-status
Package
pi-branch-status
Version
0.1.0
Published
Aug 15, 2026
Downloads
181/mo · 12/wk
Author
divyeshpuri
License
MIT
Types
extension
Size
17 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/branch-status.ts"
  ]
}

Security note

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

README

pi-branch-status

pi-branch-status adds one persistent line to Pi's default footer so the active checkout's health is visible without asking the agent.

It shows:

  • an underlined, clickable PR #… ↗ link when the branch has a GitHub PR;
  • PR conflicts or mergeability, draft/blocking/behind state, and CI state;
  • local clean/dirty state, unmerged conflicts, and upstream ahead/behind counts;
  • compact No PR, detached-HEAD, or unavailable states when context is missing.

The extension never blocks Git or GitHub actions. It refreshes local Git state every 10 seconds and after each settled agent run. GitHub status refreshes at most once per minute unless the branch or HEAD changes. Run /branch-status to force a refresh and show the copyable PR URL and full summary.

Requirements

  • Pi >=0.80.6 <0.85.0
  • Git
  • GitHub CLI (gh) authenticated for PR and CI information

Local Git status remains available when gh is missing, unauthenticated, or offline.

Install

This repository loads the package through .pi/settings.json. In another trusted workspace, install the local package while developing:

pi install ./path/to/pi-branch-status

Development

npm test
npm run check
npm pack --dry-run