ACE - Git Commit

Intention-aware conventional commit generation from diffs. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates

ace-git-commit demo

ace-git-commit helps developers and coding agents turn repository changes into clear, scoped conventional commit messages while staying inside the terminal workflow. It analyzes diffs, supports intention hints, and handles monorepo scope-based splitting (separate commits per package) automatically.

How It Works

  1. Stage changes (by default) and analyze the diff to determine scope, type, and purpose.
  2. Generate a conventional commit message using LLM analysis via ace-llm, optionally guided by an intention hint.
  3. Create the commit, or split into multiple scope-based commits for monorepo change sets.

Use Cases

Generate high-quality commits from staged or unstaged changes - run ace-git-commit to stage, analyze the diff, and produce a conventional commit message. Use /as-git-commit for the full agent-driven workflow.

Guide message intent when diff context is not enough - pass -i "fix auth bug" so the generated message reflects purpose, not only file deltas.

Handle monorepo work without manual commit slicing - commit path-scoped changes directly or rely on scope-aware splitting across packages with --no-split to override when needed.

Preview and control commit behavior safely - use --dry-run to preview, --only-staged for strict staging, or -m for explicit messages, with configuration cascade from ace-support-config for project and user overrides.

Configuration

Override the default LLM model in .ace/git/commit.yml (see defaults for all options), or replace any prompt template in .ace-handbook/prompts/ to match your commit style.

Getting Started | Usage Guide | Handbook - Skills, Agents, Templates | Part of ACE