Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
Saved setup from 2 h ago
Will it work on Windows?
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git. The repo uses git submodules, so the clone fetches them too.
git clone --recurse-submodules https://github.com/code-yeongyu/lazycodex.git cd lazycodex
Node.js 24
winget install CoreyButler.NVMforWindows nvm install 24 nvm use 24
npm ci
npm test
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.
No reports for Windows yet.
GitManual AI Agent reads the 8 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.