Commands
LazyCodex commands invoked from the Codex composer: $init-deep, $ulw-plan, $start-work, and $ulw-loop.
LazyCodex installs $command entries that you type inside the Codex composer. They are not shell commands; they are workflow entry points inside a Codex session. After installation, the items you see when you press $ belong here.
Core Commands
| Command | Type this | What it does |
|---|---|---|
$init-deep | $init-deep | Generates hierarchical AGENTS.md project memory. Run it on a large or freshly changed codebase. |
$ulw-plan | $ulw-plan "what to build" | Explores, asks questions, then writes a decision-complete plan to .omo/plans/<slug>.md. It does not write product code. |
$start-work | $start-work [plan-name] [--worktree <path>] | Executes a plan from .omo/plans checkbox by checkbox. Prints ORCHESTRATION COMPLETE when done. |
$ulw-loop | $ulw-loop "task" | Uses .omo/ulw-loop state and an evidence ledger to keep working until completion is verified. |
How They Compose
Think of the usual path in three steps. First build project memory, then plan work that needs decisions, then execute the plan. Use $ulw-loop only when an open goal needs to be pushed until evidence proves it is done.
Create Project Memory
On a large codebase, run $init-deep first. Later commands can read the AGENTS.md hierarchy and start with better context.
$init-deepPlan and Execute
If the implementation needs decisions first, write a plan and hand that plan to $start-work.
$ulw-plan "add OAuth login with refresh tokens"
$start-work$ulw-plan interviews you, explores the codebase, and writes .omo/plans/<slug>.md without touching product code. $start-work then executes that plan one checkbox at a time.
Verified Completion for Open Work
When work should continue until evidence proves completion, not merely until a hopeful status report appears, run the loop.
$ulw-loop "make the flaky payment tests pass"The agent keeps working and emits completion promises, but the loop ends only after an Oracle verifies the result. If verification fails, it continues.