@yofriadi/pi-commit

AI-powered conventional commit extension for pi

Package details

extension

Install @yofriadi/pi-commit from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@yofriadi/pi-commit
Package
@yofriadi/pi-commit
Version
1.0.0
Published
Feb 17, 2026
Downloads
11/mo · 3/wk
Author
yofriadi
License
unknown
Types
extension
Size
79.4 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-commit

Install from git URL

pi install git:github.com/yofriadi/pi-extensions@commit-v<version>

To load only this extension from the monorepo package source, use package filtering in settings:

{
  "packages": [
    {
      "source": "git:github.com/yofriadi/pi-extensions@commit-v<version>",
      "extensions": ["packages/commit/src/index.ts"]
    }
  ]
}

AI-powered conventional commit generation for pi via /commit.

Command

/commit [--dry-run] [--push] [--split] [--no-split] [--allow-mixed-index] [--context "..."] [--model provider/model]

Supported flags

  • --push: push after commit
  • --dry-run: preview commit message(s) only
  • --split: force split-commit planning
  • --no-split: disable automatic split-commit planning
  • --max-split-commits <2-12>: cap split plan size
  • --allow-mixed-index: bypass split safety guard for staged+unstaged same-file edits
  • --context, -c: extra context for generation
  • --model, -m: override model (id or provider/id)
  • --no-changelog: skip changelog updates
  • --legacy: accepted for compatibility (same pipeline)

Features

  • Conventional commit generation with validation + fallback
  • Automatic split-commit planning with dependency ordering
  • Hunk-level staging for split commits (all / hunk indices / line ranges), including new/untracked files when selected as all
  • Split safety guard for mixed index/worktree files (override with --allow-mixed-index)
  • Split execution failure handling with index reset + best-effort staged-state restore before first split commit
  • Changelog orchestration for CHANGELOG.md unreleased sections (with cached target discovery)
  • Sensitive analysis controls: sensitive paths excluded from model diff input and common secret-like values redacted
  • Runtime-compatible with both Node.js and Bun (no Bun-only APIs)