ACE - Git

Git workflows and context commands for developers and AI agents. 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 demo

ace-git gives developers and coding agents focused git context commands and guided workflows that keep history operations traceable, review-friendly, and safe to execute from the terminal. It handles status, diff, branch, PR context, and structured rebase and reorganization flows.

How It Works

  1. Query repository state with context commands for status, diff, branch, and pull request metadata.
  2. Run guided workflows for changelog-preserving rebases, commit reorganization, and PR creation or update.
  3. Review results with smart diff output in summary and grouped-stats formats before publishing.

Use Cases

Check repo and PR context without leaving the CLI - inspect branch, change, and pull request state quickly with ace-git before running higher-risk history operations.

Rebase with changelog-safe workflow guardrails - use the as-git-rebase agent workflow to run structured rebase flows that preserve package release metadata and reduce manual conflict-prone steps.

Prepare clean review history before publishing - run the as-git-reorganize-commits workflow to reorganize commit stacks, then use as-github-pr-create or as-github-pr-update to manage PR metadata in a predictable workflow sequence. See Handbook for the full skill and workflow catalog.

Coordinate with commit and worktree tools - pair with ace-git-commit for scoped commit authoring, ace-git-worktree for task-oriented worktree management, and ace-bundle for loading workflow instructions.

Testing Contract

ace-git follows the restarted package test model:

  • ace-test ace-git for deterministic fast-loop coverage (test/fast/)
  • ace-test ace-git feat for deterministic feature/contract coverage (test/feat/)
  • ace-test-e2e ace-git for retained workflow scenarios (test/e2e/)
  • ace-test ace-git all for full package verification

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