@agnishc/edb-herald

Pi extension: git commit and PR agent with approval gates

Package details

← Back
extension

Install @agnishc/edb-herald from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@agnishc/edb-herald
Package
@agnishc/edb-herald
Version
0.5.1
Published
May 5, 2026
Downloads
238/mo · 238/wk
Author
agnishc
License
MIT
Types
extension
Size
15.9 KB
Dependencies
0 dependencies · 1 peer
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

@agnishc/edb-herald

A Pi CLI extension that acts as a git commit and PR agent. It reads the current diff, groups changes into logical commits, shows a plan for your approval, executes commits, then pushes and creates a GitHub PR — all step by step with explicit approval gates.

Herald never commits or pushes without your explicit confirmation.

Commands

Command What it does
/herald Full flow: group → commit → push → PR
/herald commit Commit only (no push, no PR)
/herald pr PR only (assumes commits are already done)

Flow

  1. Reads git diff, git status, and git log
  2. Reads final-plan.md if present (for context on what was built)
  3. Groups changes into logical commits by concern and layer
  4. Generates commit messages following the better-commits convention (✨ feat(scope): subject)
  5. Shows the full plan — waits for your approval before touching anything
  6. Executes commits one by one
  7. Generates PR description from commit history and final-plan.md
  8. Shows PR description — waits for your approval
  9. Pushes and creates the PR via gh pr create

Requirements

  • git on PATH
  • gh CLI on PATH (for PR creation)

Install

pi install npm:@agnishc/edb-herald

License

MIT © Agnish Chakraborty