pi-smart-commit

Auto-generate conventional commit messages from your Pi session diffs — with confirmation.

How it works

1. Reads your git diff
2. Classifies the change: feat, fix, refactor, chore, docs, test, or style
3. Extracts context from your recent conversation
4. Generates a proper conventional commit message
5. Shows it to you for confirmation before committing

Example

git diff → +45 -12 across 3 files

fix(auth): refactor JWT middleware to use async verification

Changed: auth.ts, middlewares/, types.ts
Context: Refactor the auth middleware to use JWT instead of sessions
Changes: +45 -12

Classification logic

Type	Triggered by
feat	New files created
fix	≤2 files changed or small diffs
refactor	Mostly deletions
docs	.md, docs/, README, CHANGELOG
test	.test., .spec., tests/, __tests__/
chore	package.json, config files, CI
style	CSS, SCSS, theme files

Install

# npm
pi install npm:pi-smart-commit

# GitHub
pi install git:github.com/Jaraxxxx/pi-smart-commit

Usage

Method	Action
/commit	Generate commit message, confirm, commit
Ctrl+K	Same as /commit (keyboard shortcut)

The LLM can also call the smart_commit tool directly.

Workflow

User: "Let's refactor the auth middleware"
Agent: [reads files, makes changes]
Agent: [calls smart_commit]
       → fix(auth): refactor JWT to use async verify
       → "Changed: auth.ts, middleware/, types.ts"
User confirms → committed ✅

Requirements

• Pi coding agent
• Git repository