Conventional Commit message writer from the staged diff

What it does

Writes an accurate commit message for exactly what is staged.

• The bundled script summarizes git diff --cached: files, added/deleted lines, file kinds (code, test, docs, build, CI, binary), scope candidates and renames
• Reads the last 15 commit subjects to match the repository's style: Conventional Commits or not, Japanese or English, scope names already in use
• Warns about staged .env files, private keys, and added lines that look like tokens or passwords
• Suggests splitting the commit when code changes span 3 or more areas
• Marks breaking changes with ! and a BREAKING CHANGE: footer

How to use

python scripts/staged_summary.py --repo .

Then ask the agent to write a commit message for the staged changes. Works with Claude, Codex, Hermes Agent and Cursor. The agent runs git commit -F only when you ask it to commit.

Requirements

• Python 3 (standard library only)
• Git

Caveats

• The script is read-only; it never stages or commits.
• If nothing is staged, the agent asks instead of staging on its own.
• The type hint comes from file names only; the final type is decided from the diff itself.
• Secret detection uses simple patterns and will not catch everything.