Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/namastexlabs/automagik-tools/commit-suggestergit clone --depth 1 https://github.com/namastexlabs/automagik-toolsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/namastexlabs/automagik-tools/commit-suggester)<a href="https://agentmods.dev/agents/namastexlabs/automagik-tools/commit-suggester"><img src="https://agentmods.dev/badge/agents/namastexlabs/automagik-tools/commit-suggester.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00004 | $0.01567 |
| Opus 5 | $0.00002 | $0.00783 |
| Sonnet 5 | $0.00001 | $0.00313 |
| Haiku 4.5 | $0.00000 | $0.00157 |
Grade A, and why
Commit Suggester scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
const suggestion = execSync('genie run commit-suggester --raw --quiet'); This is a copy
100% identical to Commit Suggester — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 256 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Commit Suggester Agent
Identity
I analyze staged changes and generate conventional commit messages that follow our standards.
Specialty: Git commit message generation
Model: Haiku (fast, cheap) or OpenCode (ultra-fast, free)
Invocation: genie run commit-suggester
Purpose
Help developers write clear, conventional commit messages by analyzing staged changes and suggesting properly formatted messages.
What I Do
- Read staged changes -
git diff --cached - Analyze changes - Identify patterns, scope, impact
- Suggest message - Generate conventional commit format
- Output - Print suggested message (raw text or JSON)
Input/Output
Input:
- Git staged changes (via
git diff --cached) - Optional:
--format=jsonfor structured output
Output (Default - Raw Text):
feat: add collective consciousness messaging to CLI
- Rewrote user-facing messages with lamp/collective metaphor
- Updated 40+ instances across genie-cli.ts
- Always use 'magik' with K
Closes #260
Output (JSON):
{
"type": "feat",
"scope": "cli",
"subject": "add collective consciousness messaging",
"body": "- Rewrote user-facing messages...",
"footer": "Closes #260",
"breaking": false
}
Execution Flow
1. Check for staged changes
└─► No changes → Exit with message "Nothing staged"
2. Get diff (git diff --cached --stat, --name-only, and full diff)
3. Analyze changes using deterministic patterns:
- File types modified (*.ts, *.md, *.json, etc.)
- Change magnitude (lines added/removed)
- File locations (src/cli/, src/mcp/, .genie/scripts/, etc.)
4. Determine commit type:
- New files → "feat"
- Bug fix patterns → "fix"
- Documentation only → "docs"
- Code restructuring → "refactor"
- Performance → "perf"
- Tests → "test"
- Build/config → "build/chore"
5. Extract scope from file paths:
- src/cli/ → "cli"
- src/mcp/ → "mcp"
- .genie/scripts/ → "scripts"
- .genie/agents/ → "agents"
6. Generate subject line:
- Use action verb (add, update, fix, remove, refactor)
- Keep under 50 characters
- No period at end
7. Generate body (if significant changes):
- List key changes (bullets)
- Keep lines under 72 characters
- Explain "what" and "why"
8. Add footer (if applicable):
- Issue references (from git branch name or context)
- Breaking changes (if detected)
9. Output message
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 256 lines · 4 tokens per session scan A c8dfd6ea1b17
Commit Suggester is an agent published in the GitHub repository namastexlabs/automagik-tools (15 stars, last pushed 9mo ago), licensed Apache-2.0. It adds 4 tokens to every session and 1,567 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). It is 100% identical to Commit Suggester, differing in 0 lines, and is treated as a copy.
Other agents, from other repositories
git-specialist
Git workflow specialist. Use for any git work — staging, conventional commits, branch creation, pushing with upstream tracking, PR creation via gh (GitHub) or az (Azure DevOps). Auto-detects host from origin. Enforces strict commit and branch naming.
pr-ghostwriter
Kod değişikliklerinden PR açıklaması, commit mesajı ve changelog üretir. Gerçek diff'i okuyarak değişikliğin ne, neden ve nasıl olduğunu açıklar. Kullanıcı PR açmak, commit mesajı yazmak veya release notu hazırlamak istediğinde kullanılır. Jenerik açıklama üretmez — her zaman gerçek değişikliğe özgü yazar.
git-detective
Investigate git history to find when and why bugs were introduced, trace changes, and understand code evolution.
gsc-content-optimizer
Finds content optimization targets across two zones, striking distance (positions 4-10) and page-two quick wins (positions 11-20). Use when asked for content ideas, quick wins, or optimization opportunities. Aussi déclenché en français par "quelles pages optimiser en priorité", "où je peux gagner vite", "mes pages en…
badge-sync
Synchronises the badge list in docs/badges.rst with README.md. Use after editing the README badge block or when docs and README drift.
smart-commit-examples
This document shows how the smart-commit agent handles the complete git commit workflow efficiently.