The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
JavaScript aiai-agentsclaudeclaude-codeclicodexdeveloper-toolslazylazycodexoh-my-openagentomoopenaiorchestrationtypescript
docs(readme): document $init-deep invocation, verify/uninstall flow, and agent roles
YeonGyu-Kimfe2e18fdbac1
diff --git a/README.md b/README.mdindex d4dd2159..148c92a5 100644--- a/README.md+++ b/README.md@@ -52,6 +52,27 @@ This is shorthand for `npx --yes --package oh-my-openagent omo install --platfornpx lazycodex-ai install --no-tui --codex-autonomous```+### Verify it worked++```bash+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++```bash+npx lazycodex-ai uninstall+```++Removes the installed plugin cache, bin links, agent roles, and the managed+sections of `~/.codex/config.toml`.+## ⚡ CommandsLazyCodex installs these as OmO commands for Codex. Invoke them with the@@ -71,11 +92,12 @@ LazyCodex should be judged by the features it actually installs. It is theCodex distribution for OmO's agent harness: project memory, planning,execution, verified completion, skills, hooks, model routing, and diagnostics.-### 1. `/init-deep` creates project memory+### 1. `$init-deep` creates project memory-`/init-deep` generates hierarchical `AGENTS.md` context. It scores complex+`$init-deep` generates hierarchical `AGENTS.md` context. It scores complexdirectories, writes local guidance near the code that needs it, and gives future-agents landmarks before they edit.+agents landmarks before they edit. Type `$init-deep` in the Codex composer —+the `$` prefix is how every installed skill is invoked.Use it when the repository is too large to explain from memory. Run it againwhen the shape of the codebase changes.@@ -98,7 +120,7 @@ actual work:| Feature | Use it for || --- | --- |-| `/init-deep` | Hierarchical project memory through `AGENTS.md` |+| `$init-deep` | Hierarchical project memory through `AGENTS.md` || `$ulw-plan` | Decision-complete planning before code changes || `$start-work` | Durable plan execution with Boulder progress || `$ulw-loop` | Verified completion for open-ended tasks |@@ -111,6 +133,22 @@ actual work:| `rules` | Project instructions from AGENTS, rules, and instruction files || `comment-checker` | Feedback after edit-like operations |+### 4. Sub-agent roles ride Codex's native multi-agent tools++LazyCodex installs selectable agent roles into `~/.codex/agents/`: `explorer`,+`librarian`, `plan`, `momus`, `metis`, and `codex-ultrawork-reviewer`. Pick one+by passing `agent_type` to Codex's `spawn_agent` tool — the child agent runs+with that role's model and instructions:++```jsonc+spawn_agent({"message": "TASK: map the auth flow end to end.", "agent_type": "explorer"})+```++The installer exposes `agent_type` on `multi_agent_v2` sessions (Codex hides it+by default). If your Codex build's spawn tool has no `agent_type` parameter,+describe the role inside `message` instead — the skills are written to fall+back to that form automatically.+Start at [https://lazycodex.ai](https://lazycodex.ai).<hr />diff --git a/test/readme-feature-workflows-content.test.mjs b/test/readme-feature-workflows-content.test.mjsindex 5f7dbf03..2f9329e6 100644--- a/test/readme-feature-workflows-content.test.mjs+++ b/test/readme-feature-workflows-content.test.mjs@@ -8,16 +8,21 @@ const HANGUL_PATTERN = /[\u1100-\u11ff\u3130-\u318f\uac00-\ud7af]/utest("README documents built-in LazyCodex workflows without Hangul", () => {const requiredSnippets = ["Use the built-in workflows",- "/init-deep",+ "$init-deep","project memory","$ulw-plan","$start-work","$ulw-loop","review-work","remove-ai-slops",+ "agent_type",+ "lazycodex-ai doctor",+ "lazycodex-ai uninstall","https://lazycodex.ai",]+ assert.doesNotMatch(README, /`\/init-deep`/)+for (const snippet of requiredSnippets) {assert.match(README, new RegExp(snippet.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")))}