pi-git-commands

Pi agent extension that registers /git-commit, /git-push, and /git-tag commands.

It reuses the current conversation model to analyze git diff and generate Conventional Commits messages. It also supports Git tag creation, deletion, and listing.

Installation

# npm
pi install npm:pi-git-commands

# GitHub
pi install git:github.com/helloHupc/pi-git-commands

Or install manually:

mkdir -p ~/.pi/agent/extensions/git-commands
cp extensions/*.ts ~/.pi/agent/extensions/git-commands/

Run /reload after installation.

Usage

/git-commit

/git-commit              Generate an English commit message with LLM
/git-commit zh            Generate a Chinese commit message with LLM
/git-commit fix: typo    Commit directly with a custom message

Flow:

1. Run git add . to stage all changes.

2. Analyze staged diff with LLM and generate a commit message. Status bar shows Analyzing diff....

3. Show first 3 lines as preview.

4. Choose an action:

   feat(auth): add login page
   
   → ✓ Accept
     ✏ Custom...
     ✕ Cancel
   

   • Accept — commit with generated message.
   • Custom — open input box for a custom message.
   • Cancel — cancel commit.

/git-push

/git-push              Same as /git-commit, then run git push
/git-push zh            Chinese mode, then push
/git-push deploy: v1.2  Custom message, then push

/git-tag

/git-tag add <tag> [message...] [--push] [--remote-name <name>]
/git-tag push <tag> [--remote-name <name>]
/git-tag delete <tag> [--remote] [--all] [--remote-name <name>]
/git-tag list

Examples:

/git-tag add v1.2.0 "release v1.2.0"
/git-tag add v1.2.0 "release v1.2.0" --push
/git-tag push v1.2.0
/git-tag push v1.2.0 --remote-name upstream
/git-tag delete v1.2.0
/git-tag delete v1.2.0 --remote
/git-tag delete v1.2.0 --all --remote-name upstream
/git-tag list

Behavior:

• add creates an annotated tag by default: git tag -a <tag> -m <message>.
• If add has no message, an input box is shown. If still empty, the tag name is used as the message.
• --push pushes the tag immediately after creation. Default remote is origin.
• push pushes an existing local tag to the selected remote.
• delete deletes only the local tag by default.
• --remote deletes only the remote tag. --all deletes both local and remote tags.
• Remote tag deletion requires confirmation.
• --remote-name <name> selects a remote, for example upstream.

Language

Default language is English. Switch to Chinese:

# Environment variable, one-shot
GIT_COMMANDS_LANG=zh

# Or persistent config: ~/.pi/agent/settings.json
{
  "gitCommandsLanguage": "zh"
}

Or switch per command: /git-commit zh.

Fallback

If LLM is unavailable, the extension falls back to heuristic message generation based on changed file types and directories.

File structure

~/.pi/agent/extensions/git-commands/
├── index.ts       # Command registration, LLM calls, interactive flow, tag operations
└── prompts.ts     # English/Chinese prompt templates

Requirements

• Pi agent ≥ 0.73
• Configured model provider. The extension reuses the current conversation model and API key.