Skip to content

About

Codex CLI fork with workflows/ultracode in it.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

10,882 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex Ultracode is a Codex CLI fork with a native workflow engine: two-pane phases and workers, /workflows, pause, resume, restart, and save.

A native workflow running in Codex Ultracode

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.

Install

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"

Run

codex-ultracode --native-workflow-host -m gpt-5.6-luna --effort low

Ask 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.

Build from source

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 \
  --force

Linux 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.2

See Installing & building for the Rust toolchain.

Docs

This repository is licensed under the Apache-2.0 License.

About

Codex CLI fork with workflows/ultracode in it.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages