omegacode

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.