Lazycodex

LazyCodex

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

What is this?
·
OmO
·
lazycodex.ai

[!NOTE] [OmO] 60K Stars: the terrifying token burner has arrived in LazyCodex.

Sisyphus Labs' OmO is the quality-obsessed agent harness whose public lore says it loved Anthropic models hard enough to get third-party clients blocked. Now that same OmO quality bar is available for Codex through LazyCodex.

If you wanted OmO but did not want the setup ceremony, start here:

npx lazycodex-ai install

Context: OmO 60K Stars on X

🚀 Install

One line. No global install, no npm i -g. Always use npx:

npx lazycodex-ai install

This is shorthand for npx --yes --package oh-my-openagent omo install --platform=codex. For a fully autonomous, no-TUI setup:

npx lazycodex-ai install --no-tui --codex-autonomous

Install from the Codex marketplace (experimental)

The npx installer above stays the primary path. As an additive, experimental alternative you can install from inside Codex itself: type /plugins, open the Add Marketplace tab ("Add a marketplace from a Git repo or local root."), and enter https://github.com/code-yeongyu/lazycodex, then install omo from the sisyphuslabs marketplace. Or from the CLI:

codex plugin marketplace add https://github.com/code-yeongyu/lazycodex
codex plugin add omo@sisyphuslabs

On the next launch, approve the omo hooks in Codex's startup review — hooks never run before approval. The first approved session prints LazyCodex bootstrap running in background — restart the session when it completes while a background worker finishes the setup (config blocks, agent roles, bin links, a pinned sg binary for the ast_grep MCP); restart when it is done. The marketplace path never touches Codex permission settings — autonomous mode remains the explicit npx lazycodex-ai install --no-tui --codex-autonomous choice.

Upgrade with codex plugin marketplace upgrade sisyphuslabs. The next startup review shows the hooks as Modified — expected after every upgrade — re-approve them and the following session re-runs bootstrap on the new version. If anything looks pending or degraded, npx lazycodex-ai doctor explains what and why. Full details: lazycodex.ai/docs.

Verify it worked

npx lazycodex-ai doctor

doctor prints the installation health report: plugin cache, hooks, MCP servers, agents, and config state. Inside Codex, type $ in the composer to browse every installed skill — init-deep, ulw-loop, ulw-plan, start-work, and the rest — and hooks announce themselves with LazyCodex(<version>): ... status messages during a session.

Uninstall

npx lazycodex-ai uninstall

Removes the installed plugin cache, bin links, agent roles, and the managed sections of ~/.codex/config.toml.

⚡ Commands

LazyCodex installs these as OmO commands for Codex. Invoke them with the $command syntax shown by the installer.