What problem does it solve?
It standardizes how to create and push git commits that follow gitmoji formatting and a bead-by-bead workflow, reducing inconsistent commit messages and missed checkpoints.
Core Features & Use Cases
- Beat-aligned commits and pushes: Creates exactly one commit per bead closure, with commits aligned to natural checkpoints between beads.
- Consistent commit message structure: Enforces an emoji + scope subject line, supports an optional WHY body, and includes bead metadata plus co-author attribution.
- Safety-focused staging rules: Guides selective staging (never git add -A or git add .) and warns against committing secrets like .env or credentials.
- Worktree-aware pushing: Prevents pushing when operating in worktrees with branch names starting with worktree-agent-.
Quick Start
Run the commit workflow in order by closing the relevant bead, syncing bead state, staging only the specific changed files and the bead issues file, then creating the commit message using the required format and pushing to the remote if not in a worktree.