yuanpingsong/ultracodex

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.