ACE - Test Runner

AI-friendly test runner with smart grouping, failure analysis, and persistent reports. 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-test-runner demo

ace-test-runner wraps Minitest with smart target resolution, cross-package execution, and persistent reports so both developers and coding agents can run focused checks quickly, diagnose failures with context, and retain searchable execution history. It handles the execution side of testing; use ace-test for planning, review, and suite improvement workflows.

How It Works

  1. Resolve the target package and test scope from a package name, target (atoms, molecules, organisms, models, fast, feat, all, quick), or direct file:line selector.
  2. Execute the matching tests with failure-oriented output and optional profiling of the slowest cases.
  3. Persist structured run reports for historical debugging and searchable triage across runs.

Use Cases

Run package tests from anywhere in the monorepo - execute ace-test [package] by name without changing directories, keeping outputs consistent across local and CI environments.

Target exactly the scope you need - run by test targets (ace-test atoms, ace-test molecules) or direct file/line selectors (ace-test test/file_test.rb:42) to focus on the code you are changing.

Keep fast-loop defaults tight - run ace-test <package> for fast coverage by default, then opt into feat when you need deterministic feature checks with controlled IO.

Speed up triage on broken builds - use failure-oriented output and persisted reports to locate regressions and continue diagnosis without rerunning broad suites.

Validate the full monorepo before shipping - run ace-test-suite for cross-package execution orchestration, and use ace-test-e2e <package> when you need scenario E2E coverage.

Profile slow tests - run ace-test molecules --profile 10 to identify the slowest tests and prioritize optimization with ace-test performance audit workflows.

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