whatisgithub

What is ultracodex?

yuanpingsong/ultracodex — explained in plain English

Analysis updated 2026-05-18

62TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

ultracodex runs Claude Code style agent workflow scripts on an OpenAI Codex or OpenCode subscription, letting you fan out, loop, and schedule AI agent calls from plain JavaScript.

Mindmap

mindmap
  root((ultracodex))
    What it does
      Runs workflow scripts on Codex
      Fans out agent calls
      Loops until verified
    Tech stack
      TypeScript
      Node.js
      Codex CLI
    Use cases
      Parallel agent review
      Verifier approved loops
      Scheduled agent runs
    Audience
      AI agent developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run existing Claude Code workflow scripts on an OpenAI Codex subscription without modifying them.

USE CASE 2

Fan a task out to multiple parallel AI agent reviewers and combine their verified results.

USE CASE 3

Loop a workflow automatically until a skeptical verifier agent approves the output.

What is it built with?

TypeScriptNode.jsCodex CLI

How does it compare?

yuanpingsong/ultracodexn8n-io/tournamentbike4mind/bike4mind
Stars626261
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-04-28
MaintenanceMaintained
Setup difficultymoderateeasymoderate
Complexity4/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+, the Codex CLI installed and authenticated, and typically a driving agent like Claude Code.

Apache License 2.0: use, modify, and distribute freely, including for commercial purposes, with attribution and a patent grant from contributors.

So what is it?

ultracodex lets you take workflow scripts written for Claude Code and run them, unchanged, using an OpenAI Codex subscription instead, and it also supports a third backend called OpenCode. The core idea is that an AI agent can be treated like a unit of programming: you write ordinary JavaScript, call an agent the way you would call a function, and get back a structured result. Because ultracodex hides the differences between the three backends, the same script can run on whichever one you happen to have available, which means the heavy work of running many agent calls can land on a subscription you are not trying to conserve, rather than the one you use for everyday coding. A workflow script is a plain JavaScript module built around a handful of built-in functions: agent, which runs a single AI agent call and can return a schema-validated result or fail gracefully, parallel, which runs several agent calls at once and waits for all of them, pipeline, which pushes items through a chain of stages without waiting for every item to finish the same stage together, plus helpers for grouping progress into phases, logging messages, reading arguments, and tracking a token budget. Beyond running a single workflow, ultracodex adds ways to loop a workflow until a skeptical verifier approves the result, schedule workflows to run on a timer, and, in an experimental mode, keep a longer running group of agents with memory between runs. Getting started involves installing the ultracodex command line tool with npm, running a doctor command that checks your setup, and running a sync command that teaches a coding assistant like Claude Code how to write and run these scripts for you. From there, you can simply describe a task in plain language to your assistant and have it write and execute the workflow, or you can run a script or a named workflow directly from the command line yourself, with options to set a token budget, watch progress live, or run in the background as a separate process. The project requires Node.js version 20 or newer and the Codex command line tool to be installed and logged in. It is released under the Apache License 2.0.

Copy-paste prompts

Prompt 1
Explain how ultracodex lets the same workflow script run on Codex, Claude, or OpenCode.
Prompt 2
Walk me through installing ultracodex and running ultracodex sync-skills to teach my coding agent.
Prompt 3
Show me a simple ultracodex workflow script that reviews files in parallel and verifies the findings.
Prompt 4
What is the difference between the parallel and pipeline functions in an ultracodex workflow script?

Frequently asked questions

What is ultracodex?

ultracodex runs Claude Code style agent workflow scripts on an OpenAI Codex or OpenCode subscription, letting you fan out, loop, and schedule AI agent calls from plain JavaScript.

What language is ultracodex written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Codex CLI.

What license does ultracodex use?

Apache License 2.0: use, modify, and distribute freely, including for commercial purposes, with attribution and a patent grant from contributors.

How hard is ultracodex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ultracodex for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.