Quick Start | Vision | Architecture | Tools Reference
Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.
Coding agents can write code, but they still lack the workflow layer around the code:
- Your tasks live in a SaaS dashboard your agent can't see
- Context is scattered across files the agent doesn't know to load
- Review feedback is verbal and untracked — nothing saved, nothing actionable
- Multi-step workflows require you to babysit every transition
ACE gives agent harnesses like Claude Code and Codex CLI the workflow layer they're missing — task pipelines, context bundles, review presets, and skills — as standard CLI commands both you and your agents run the same way.
Tasks and ideas as files your agent can read
- Capture ideas and turn them into task specs with subtasks.
- Track progress in markdown files that live in your repo.
- Let any agent read the same task state you do.
ace-idea create "Add retry logic to webhook delivery" --tags reliability
ace-task create "Implement webhook retry" --priority highOne command from task to shipped PR
- Provision an isolated worktree.
- Open a tmux window for focused execution.
- Kick off a multi-step assignment that runs implement, test, review, and ship.
ace-overseer work-on --task 8r3ace-overseer orchestrates ace-assign, ace-git-worktree, and ace-tmux
Multi-model code review with tracked feedback
- Run the same diff through multiple LLM providers.
- Compare review output side by side.
- Track suggestions through a verified, pending, and resolved lifecycle.
ace-review --preset code-deep --pr 123Context loading on demand
- Load project context, workflow instructions, and guides through
wfi://,guide://, andtmpl://. - Bundle context for agents or load it directly yourself.
ace-bundle wfi://task/workace-bundle | ace-handbook | ace-search
Start small with smart commits, or install the full orchestration stack:
gem install ace-git-commit # smart commits, zero config
gem install ace-overseer # full orchestrator stackRuby 3.2+ required. Each ace-* gem installs independently, so you can start with one tool and add more as needed.
- CLI-first, agent-agnostic — every tool is a standard CLI command; if it can run bash, it can use ACE
- Everything in git — tasks, workflows, configs, and review sessions are markdown and YAML files in your repo
- Transparent and inspectable — dry-run support, readable configs, saved sessions; when something breaks, you can trace it
- Customizable cascade — each package ships defaults; override at user (
~/.ace/) or project (.ace/) level without forking
- Plan:
ace-ideato capture and shape ideas,ace-taskfor markdown task specs with subtasks,ace-retrofor retrospectives. - Build:
ace-overseerto orchestrate task pipelines,ace-assignfor multi-step assignments,ace-git-worktreefor isolated worktrees,ace-git-commitfor intention-aware commits. - Review:
ace-reviewfor multi-model preset reviews,ace-test-runnerfor smart test execution,ace-lintfor linting,ace-docsfor doc freshness tracking. - Context:
ace-bundlefor context assembly,ace-handbookfor workflows, guides, templates, and skills,ace-searchfor codebase search,ace-llmfor multi-provider LLM queries. - Secure:
ace-git-secretsfor credential leak scanning and revocation.
40+ packages total, including shared libraries and agent platform integrations. See Tools Reference for the complete inventory.
ACE skills project natively to multiple agent platforms. Install an integration package and workflows, guides, and skills appear in your agent's expected directory structure.
