# omegacode

> Agent-agnostic JavaScript workflow orchestrator for coding agents like Claude Code and Codex, using a small deterministic DSL to coordinate parallel and sequential agent runs.

omegacode is an open-source CLI tool built by Sawyer Hood that lets developers orchestrate fleets of coding agents — including Claude Code and OpenAI Codex — using plain JavaScript workflow files. It is available under the MIT License and installable globally via npm, requiring Node 20 or later and at least one supported agent worker.

## What It Is

omegacode provides an agent-agnostic runtime for Claude Code's workflow concept. Instead of being tied to a single AI coding agent, it introduces a small deterministic DSL — `agent()`, `parallel()`, `pipeline()`, and `phase()` — injected into plain JavaScript files so no imports are needed. The same workflow file can drive Claude Code, Codex, or both in a single run, enabling cross-provider diversity and adversarial review patterns.

## How the DSL Works

Workflows are `.workflow.js` files that export a `meta` object and use the injected DSL primitives:

- **`agent(prompt, options)`** — spawns a real Codex or Claude Code agent subprocess
- **`parallel(tasks)`** — fans out multiple agents concurrently
- **`pipeline(items, fn)`** — maps a function over items sequentially or in stages
- **`phase(name)`** — labels a logical phase for the live dashboard and journal

The `provider` option on each `agent()` call can be omitted to inherit the run-level default, or pinned per call to force a specific model — enabling workflows where one model proposes and another critiques.

## Built-In Workflows

Six workflow templates ship with the package out of the box:

- **`deep-research`** — multi-step research with fan-out and synthesis
- **`code-review`** — standard single-provider review
- **`multi-provider-review`** — both Claude Code and Codex review the same branch independently, then a synthesis merges results
- **`bake-off`** — both models implement the same task in isolated worktrees; blind cross-provider judges pick a winner
- **`provider-debate`** — propose → attack → rebut for N rounds, then a judge rules
- **`second-opinion`** — both answer cheaply; agreement returns merged, disagreement escalates to deep effort and adjudicates

## Setup Path

Installation is a two-step process: install the npm package globally, then run `omegacode install-skill` to copy the authoring guide into `~/.claude/skills/` (for Claude Code) and `~/.agents/skills/` (for Codex-compatible agents). The `--claude` or `--agents` flags limit installation to one target. Running `omegacode doctor` checks that the required worker binaries are available.

## Resumability and Observability

Runs are journaled to disk, making them resumable: `omegacode run <name> --resume <runId>` re-runs only the changed suffix of a workflow. The `omegacode serve` command opens a live read-only dashboard showing every agent's status as it works, and `run` auto-starts the viewer by default.

## Current Status

The repository was created in early June 2026 and last updated June 9, 2026, with CI passing on the main branch. It has 9 stars and is an early-stage project with one open issue. The MIT license makes it freely usable, modifiable, and distributable.

## Features
- Agent-agnostic workflow orchestration
- Supports Claude Code and Codex workers
- Deterministic DSL: agent(), parallel(), pipeline(), phase()
- Plain JavaScript workflow files with no imports required
- Cross-provider diversity in a single workflow run
- Six built-in workflow templates (deep-research, code-review, bake-off, etc.)
- Live dashboard via omegacode serve
- Journaled and resumable runs
- Skill installation for Claude Code and Codex agents
- omegacode doctor for environment health checks
- omegacode guide for full authoring reference

## Integrations
Claude Code, OpenAI Codex, Node.js

## Platforms
WEB, API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/SawyerHood/omegacode
- Repository: https://github.com/SawyerHood/omegacode
- EveryDev.ai: https://www.everydev.ai/tools/omegacode