@agnishc/edb-herald
v0.10.6
Published
Pi extension: git commit and PR agent with approval gates
Maintainers
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
- Reads
git diff,git status, andgit log - Reads
final-plan.mdif present (for context on what was built) - Groups changes into logical commits by concern and layer
- Generates commit messages following the
better-commitsconvention (✨ feat(scope): subject) - Shows the full plan — waits for your approval before touching anything
- Executes commits one by one
- Generates PR description from commit history and
final-plan.md - Shows PR description — waits for your approval
- Pushes and creates the PR via
gh pr create
Requirements
giton PATHghCLI on PATH (for PR creation)
Install
pi install npm:@agnishc/edb-heraldLicense
MIT © Agnish Chakraborty
