pi-git-commands-extension

Shareable Pi package that adds /commit, /push, /commit-and-push, and /commit-pr git commands.

Package details

extension

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

$ pi install npm:pi-git-commands-extension
Package
pi-git-commands-extension
Version
0.1.3
Published
Apr 12, 2026
Downloads
274/mo · 6/wk
Author
tsprotte
License
MIT
Types
extension
Size
39.3 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-git-commands-extension

A standalone Pi package that adds shareable git workflow commands:

  • /commit
  • /push
  • /commit-and-push
  • /commit-pr

The extension inspects the current repository, generates commit messages with the active Pi model, and now also looks at recent commits so generated messages stay closer to the repository's existing style.

Install

From npm

pi install npm:pi-git-commands-extension

From git

pi install git:github.com/qualiti/pi-git-commands-extension

From a local checkout

pi install /absolute/path/to/pi-git-commands-extension

Usage

After installation, reload Pi or start a new session, then use:

/commit
/push
/commit-and-push
/commit-pr

You can also pass a commit hint:

/commit fix calendar overlap validation
/commit-and-push update onboarding copy
/commit-pr add recurring event form polish

Requirements

  • git must be available on PATH
  • gh must be installed and authenticated for /commit-pr
  • Pi must have an authenticated model available to generate commit metadata

Package structure

This package follows Pi package guidelines:

  • it declares a pi manifest in package.json
  • it exposes the extension through ./extensions
  • it uses Pi core packages as peerDependencies
  • 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-commands-extension

Or load the extension file directly for quick testing:

pi -e /absolute/path/to/pi-git-commands-extension/extensions/git-commands.ts

Files

  • package.json — Pi package manifest for npm and git installs
  • extensions/git-commands.ts — the extension entry point
  • .github/workflows/ci.yml — package validation on pushes and pull requests
  • .github/workflows/publish.yml — npm publish workflow for releases

Notes

This repository intentionally keeps the extension as plain TypeScript with no build step, matching Pi's extension packaging model.