Parallel agent orchestration CLI — split large tasks into sections that execute concurrently via AI coding agents, each working in a shared git worktree.
Aeon works with Codex, Claude Code, and OpenCode as backends.
- Plan — Define (or AI-generate) a set of parallel sections, each with its own scope and acceptance criteria
- Execute — Aeon launches one agent per section in a shared git worktree, all running concurrently
- Monitor — A fullscreen interactive TUI shows real-time progress, output, and token usage for every agent
- Merge — Changes are auto-committed to a shared integration branch
┌──────────────────────────────────────────┐
│ aeon · Codex · o4-mini 2m 34s │
│ parse → setup → forge → merge → done │
│──────────────────────────────────────────│
│ › ✓ 1 Auth system done 12.4K │
│ ● 2 API endpoints run 8.2K │
│ ● 3 Database layer run 6.1K │
│ ○ 4 Tests wait – │
└──────────────────────────────────────────┘
- Bun v1.0+ (runtime & bundler)
- Node.js 20+ (for npm global install)
- At least one agent CLI installed:
codex—npm install -g @openai/codexclaude—npm install -g @anthropic-ai/claude-codeopencode— See opencode-ai/opencode
git clone https://github.com/Open-Document-Alliance/Aeon.git
cd Aeon
npm install --install-strategy=nested
bun run build
npm install -g .Verify:
aeon --helpWhy
--install-strategy=nested? Aeon uses React 19 with OpenTUI. Nested installs ensure both packages resolve the same React runtime, preventing the "multiple React runtimes" error.
cd your-project
aeon plan "Build a REST API with auth, CRUD endpoints, and tests"This invokes an agent to write a parallel plan, validates it, then immediately launches all sections.
cd your-project
aeon init # creates .aeon/plan/ with a template
# edit .aeon/plan/*.md files
aeon validate # check for errors
aeon run # launch agents| Command | Description |
|---|---|
aeon init |
Create .aeon/plan/ with an example template |
aeon plan [prompt] |
AI-generate a plan from natural language, then run it |
aeon validate |
Check plan files for errors and warnings |
aeon run |
Execute the plan with an interactive TUI |
aeon prompt [section] |
Output agent prompts to stdout (for manual use) |
aeon setup |
Install Aeon skills into Claude Code / Cursor / Codex / OpenCode |
aeon status |
Show results of the last run |
aeon help |
Display help |
aeon run -b claude-code # use Claude Code backend
aeon run -b codex -m gpt-4.1 # use Codex with a specific model
aeon run --timeout 300000 # 5 minute timeout per agent
aeon run --no-cleanup # keep the integration worktree after run
aeon plan "..." --no-run # generate plan only, don't executeEach .md file in .aeon/plan/ is one parallel section:
---
title: Auth System
files:
- src/auth/**
- src/middleware/auth.ts
acceptance:
- JWT login/register endpoints work
- Auth middleware protects routes
- Tests pass
---
# Auth System
Implement JWT-based authentication with login and register endpoints.
## Details
- Use bcrypt for password hashing
- Store sessions in Redis
- Add auth middleware that validates JWT tokens| Field | Required | Description |
|---|---|---|
title |
Yes | Short human-readable name |
files |
Recommended | Glob patterns of files this section touches (for overlap detection) |
acceptance |
Recommended | Concrete acceptance criteria the agent must satisfy |
| Key | Action |
|---|---|
j / k |
Navigate sections |
Enter |
Open detail view |
s |
Open split view |
1-9 |
Jump to section |
? |
Toggle help |
q |
Quit |
| Key | Action |
|---|---|
Esc |
Back to overview |
j / k |
Scroll output |
d / u |
Page scroll |
g / G |
Top / bottom |
f |
Toggle auto-scroll |
i |
Send message to agent |
[ / ] |
Previous / next agent |
v / h |
Split vertical / horizontal |
| Key | Action |
|---|---|
Tab |
Focus next pane |
1-9 |
Show section N in pane |
x |
Close pane |
+ / - |
Resize split |
i |
Message focused agent |
| Backend | CLI | Install |
|---|---|---|
| Codex (default) | codex |
npm install -g @openai/codex |
| Claude Code | claude |
npm install -g @anthropic-ai/claude-code |
| OpenCode | opencode |
github.com/opencode-ai/opencode |
Aeon remembers your last-used backend. Override with -b:
aeon run -b claude-code
aeon run -b codex
aeon run -b opencodeInstall Aeon planning/implementation skills into your editor's agent harness:
aeon setup # all detected harnesses
aeon setup --harness claude-code # Claude Code only
aeon setup --harness cursor # Cursor onlyThis installs skills so agents know how to create and execute Aeon plans when you invoke /aeon-plan or /aeon-implement.
aeon/
├── bin/aeon.js # Entry point
├── src/
│ ├── index.tsx # CLI commands (Commander.js)
│ ├── orchestrator.ts # Core orchestration engine
│ ├── types.ts # TypeScript type definitions
│ ├── utils.ts # Utilities
│ ├── cli-style.ts # ANSI color helpers
│ ├── plan/
│ │ ├── parser.ts # Plan file parser (YAML frontmatter + markdown)
│ │ └── validator.ts # Plan validation & overlap detection
│ ├── backends/
│ │ ├── driver.ts # Backend abstraction layer
│ │ ├── claude-code.ts # Claude Code driver
│ │ ├── codex.ts # Codex driver (with SDK streaming)
│ │ └── opencode.ts # OpenCode driver
│ ├── git/
│ │ └── worktree.ts # Git worktree management
│ └── tui/ # Interactive terminal UI (React + OpenTUI)
│ ├── tui-root.tsx # Root component & keyboard handling
│ ├── tui-state.ts # State management (useReducer)
│ ├── overview.tsx # Overview screen
│ ├── detail.tsx # Detail view
│ ├── split.tsx # Split pane layout
│ └── ... # Additional TUI components
├── skill/
│ ├── SKILL.md # Planning skill (agent instructions)
│ └── IMPLEMENT.md # Implementation skill
├── package.json
└── tsconfig.json
MIT