Codex Ultracode is a Codex CLI fork with a native workflow engine: two-pane phases and workers, /workflows, pause, resume, restart, and save.
This tree is based on current openai/codex main (872fc22, 2026-09-15), past rust-v0.155.0-alpha.8, plus the native workflow engine. It is not official OpenAI Codex. Use GitHub Releases from this repo. Do not install @openai/codex or the ChatGPT installer if you want this fork.
Current package version: 0.155.0-workflow.2.
Download a package from Releases:
- macOS Apple Silicon:
codex-package-aarch64-apple-darwin.tar.gz - Linux ARM64:
codex-package-aarch64-unknown-linux-gnu.tar.gz - Linux x86_64:
codex-package-x86_64-unknown-linux-gnu.tar.gz - Windows x64:
codex-package-x86_64-pc-windows-msvc.zip
macOS / Linux:
gh release download --repo Mako-L/codex-ultracode --pattern 'codex-package-<target>.tar.gz'
mkdir -p "$HOME/.local/codex-ultracode"
tar -xzf codex-package-*.tar.gz -C "$HOME/.local/codex-ultracode"
printf '%s\n' '#!/bin/sh' 'exec "$HOME/.local/codex-ultracode/bin/codex" --native-workflow-host "$@"' > "$HOME/.local/bin/codex-ultracode"
chmod +x "$HOME/.local/bin/codex-ultracode"Windows (PowerShell):
gh release download --repo Mako-L/codex-ultracode --pattern 'codex-package-x86_64-pc-windows-msvc.zip'
Expand-Archive .\codex-package-x86_64-pc-windows-msvc.zip -DestinationPath "$env:LOCALAPPDATA\codex-ultracode" -Force
@'
@echo off
"%LOCALAPPDATA%\codex-ultracode\bin\codex.exe" --native-workflow-host %*
'@ | Set-Content -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\codex-ultracode.cmd"codex-ultracode --native-workflow-host -m gpt-5.6-luna --effort lowAsk for a workflow, or type /workflows. From an empty composer, Down selects the workflow footer and Enter opens it. Resume with the same codex-ultracode launcher, not the official codex binary.
Sign in with ChatGPT or an API key the same way as upstream Codex.
Write workers default to isolated Git worktrees. When a run completes, those edits land in the project folder you opened. Clean overlaps merge automatically. Remaining conflicts start a Merge worker in that same folder instead of overwriting your files. /config can switch write workers to the current folder for the whole run.
git clone https://github.com/Mako-L/codex-ultracode.git
cd codex-ultracode
export CODEX_REPO_ROOT="$PWD"
/opt/homebrew/bin/python3 scripts/build_codex_package.py \
--target aarch64-apple-darwin \
--variant codex \
--cargo-profile release \
--node-bin /path/to/self-contained/node \
--package-dir dist/codex-package \
--archive-output dist/codex-package-aarch64-apple-darwin.tar.gz \
--forceLinux packages are built on this Mac with OrbStack, not GitHub-hosted runners:
export CODEX_REPO_ROOT="$PWD"
bash scripts/release-host-packages.sh v0.155.0-workflow.2See Installing & building for the Rust toolchain.
This repository is licensed under the Apache-2.0 License.
