pi-git-shortcuts

English | 简体中文

Context-clean Git slash commands for the Pi coding agent.

pi-git-shortcuts uses isolated in-memory agent sessions to generate commit messages and resolve rebase conflicts. The model can help with Git work without adding prompts, tool calls, or results to the main conversation context.

• /commit: stage all changes and create an AI-generated Conventional Commit.
• /pull: pull and rebase the current branch, resolving conflicts with an isolated agent.
• /push: push the current branch without creating a commit.
• /cp: commit and push in one command.
• /git-shortcuts-config: choose the model and commit message language used by Git shortcuts.
• Non-fast-forward pushes can rebase and resolve conflicts with an isolated, file-tool-only agent.
• A transient progress panel shows every Git and model stage without polluting the session.

Commands

/commit [instructions]

Stages all working-tree changes, asks an isolated agent to generate a Conventional Commit message, validates the response, and creates the commit.

/commit
/commit use a docs scope
/commit write the commit message in Chinese

/cp [instructions]

Commits changes and pushes the current branch.

/cp
/cp describe the authentication fix precisely

/pull

Pulls and rebases the current branch. If the rebase conflicts, an isolated file-tool-only agent resolves the conflicts and the extension continues the rebase.

/pull

It uses the configured upstream when available. Without an upstream, it pulls origin/<current-branch> without creating tracking configuration. It does not automatically stash uncommitted changes. If Git rejects the pull because of local changes, the command stops and leaves the working tree untouched.

/push

Pushes the current branch without staging changes or creating a commit.

/push

It creates an upstream when needed and uses the same rebase and isolated conflict-resolution workflow as /cp when the remote branch is ahead. Existing uncommitted working-tree changes are left untouched unless Git itself prevents the rebase.

/git-shortcuts-config

Opens selectors for the model used by isolated Git agents and the language of generated commit messages. Choose Use active model to follow the current Pi session model, which is the default. Otherwise, select any currently available provider/model.

English is the default commit language. Selections apply immediately and are persisted globally in:

~/.pi/agent/pi-git-shortcuts.json

The configured model is used for both commit-message generation and rebase conflict resolution. For Chinese output, the Conventional Commit type and optional scope remain in English while the description and body use Simplified Chinese.

Progress UI

While /commit, /cp, /pull, or /push is running, a temporary TUI-only panel appears above the editor:

◆ pi-git-shortcuts  commit + push  3s
├─ ✓ Checking repository
├─ ✓ Staging changes · git add -A
├─ ✓ Reading staged diff
└─ ○ Generating commit message · English · 4 file(s)

The panel advances through commit, push, rebase, and conflict-resolution stages. On success it shows the commit hash or final push result and hides after 6 seconds. Errors remain visible longer and include recovery details.

After the panel closes, one compact result remains in the chat history. It is stored as a Pi custom entry so it survives session reloads, but custom entries are excluded from the LLM context and consume no model context tokens. Expand the entry to see its duration and timestamp.

The progress panel is rendered with setWidget(). Neither progress updates nor the durable result are sent to the model.

The push workflow:

1. Reuses the /commit workflow.
2. Pushes the current branch.
3. Creates an upstream with git push -u origin <branch> when needed.
4. On a non-fast-forward rejection, runs git pull --rebase.
5. If the rebase conflicts, starts an isolated conflict-resolution agent.
6. Continues the rebase and retries the push.

If automatic conflict resolution fails, the rebase is left in progress for manual recovery. The extension does not silently reset or abort your work.

Context Isolation

The extension is intentionally command-only:

• Registers /commit, /cp, /pull, /push, and /git-shortcuts-config with pi.registerCommand().
• Does not register an LLM tool.
• Does not call sendUserMessage() or sendMessage().
• Does not append session entries.
• Persists preferences in a standalone JSON config file, not in the session.
• Uses SessionManager.inMemory() for model work.
• Shows progress and results only through Pi UI notifications.

The commit-message agent has no tools. The conflict-resolution agent is limited to these repository file tools:

read, edit, grep, find, ls

It cannot run shell or Git commands. Rebase state is controlled by the extension.

Safety Model

• /commit stages all changes with git add -A.
• Generated commit messages must follow Conventional Commit format.
• Commit headers are limited to 72 characters.
• A detached HEAD is never pushed automatically.
• An upstream is only created against the existing origin remote.
• Automatic rebase resolution is limited to 20 rounds.
• Failed conflict resolution leaves the repository recoverable in its current rebase state.

Install

Requires Pi 0.80.7 or newer.

npm

pi install npm:pi-git-shortcuts

GitHub

pi install git:github.com/LuckyYunPeng/pi-git-shortcuts

Local development

pi install /absolute/path/to/pi-git-shortcuts

After editing local source, run /reload inside Pi.

Development

npm install
npm run check

Package Layout

pi-git-shortcuts/
├── src/
│   ├── agent.ts      # isolated model sessions
│   ├── commands.ts   # /commit, /cp, /pull, and /push workflows
│   ├── config.ts     # persistent model and commit-language preferences
│   ├── git.ts        # Git helpers and validation
│   ├── progress.ts   # transient TUI progress panel
│   └── index.ts      # Pi extension entrypoint
├── test/
├── README.md
├── README.zh-CN.md
└── package.json

License

MIT. See LICENSE.