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
feat(web): add marked-based build-time docs content pipeline
YeonGyu-Kimfbc9f5173c97
diff --git a/packages/web/content/docs/installation.md b/packages/web/content/docs/installation.mdnew file mode 100644index 00000000..d8bba381--- /dev/null+++ b/packages/web/content/docs/installation.md@@ -0,0 +1,26 @@+One command gets you running. LazyCodex is currently available on OpenCode; the Codex edition is coming June 2026.++### Install++```bash+bunx lazycodex install+```++This is exactly equivalent to `bunx omo install --platform=codex`.++### Autonomous one-liner++```bash+bunx lazycodex install --no-tui --codex-autonomous+```++### Prerequisites++- [Bun](https://bun.sh)+- The [OpenAI Codex CLI](https://github.com/openai/codex)++> Do NOT use `npm install -g` or `bun add -g`. Always invoke via `bunx`.++### Let an agent do it++It is strongly recommended to let an LLM agent run the install and walk the setup for you. The agent handles subscription detection, model selection, and provider auth automatically.diff --git a/packages/web/content/docs/overview.md b/packages/web/content/docs/overview.mdnew file mode 100644index 00000000..ffe2015e--- /dev/null+++ b/packages/web/content/docs/overview.md@@ -0,0 +1,16 @@+LazyCodex is the lazy way to get [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) (OmO) up and running inside Codex. Think [LazyVim](https://github.com/LazyVim/LazyVim) for [lazy.nvim](https://github.com/folke/lazy.nvim), but for Codex.++### What you get++OmO is a full AI dev team in a harness. It gives you discipline agents (Sisyphus orchestrates Hephaestus, Oracle, and Librarian), parallel execution, multi-model routing, a skills system, hooks and lifecycle, and zero-config defaults. LazyCodex wraps the entire setup so you don't have to think about it.++### The one-word workflow++You don't need to ultrathink. Just prompt with `{your prompt} ultrawork`. One word, and every agent activates.++### How it fits together++LazyCodex is a thin distribution layer. The core engine is [OmO](https://github.com/code-yeongyu/oh-my-openagent). LazyCodex is maintained by [Sisyphus Labs](https://sisyphuslabs.ai).++- [LazyCodex on GitHub](https://github.com/code-yeongyu/lazycodex)+- [OmO on GitHub](https://github.com/code-yeongyu/oh-my-openagent)diff --git a/packages/web/content/docs/start-work.md b/packages/web/content/docs/start-work.mdnew file mode 100644index 00000000..acec0722--- /dev/null+++ b/packages/web/content/docs/start-work.md@@ -0,0 +1,19 @@+`$start-work` executes a Prometheus work plan until every top-level checkbox is done.++### How it works++- Durable Boulder state in `.omo/boulder.json` survives across turns and sessions+- A Stop-hook re-injects the next turn until the plan is complete+- Independent sub-tasks fan out to parallel subagents+- Strict TDD plus five evidence gates: plan reread, automated verification, manual-QA, adversarial QA, cleanup+- Progress is recorded to a ledger++### Syntax++```bash+/start-work [plan-name] [--worktree <absolute-path>]+```++### Done++It prints an `ORCHESTRATION COMPLETE` block when every checkbox is checked.diff --git a/packages/web/content/docs/ultrawork.md b/packages/web/content/docs/ultrawork.mdnew file mode 100644index 00000000..e7f22c25--- /dev/null+++ b/packages/web/content/docs/ultrawork.md@@ -0,0 +1,16 @@+ultrawork is the headline mode. Typing `ultrawork` (or the short alias `ulw`) anywhere in your prompt activates maximum-precision, outcome-first, evidence-driven orchestration.++> "One word. Every agent activates. Doesn't stop until done."++### Usage++```bash+ulw add authentication+```++### What it enforces++- Strict TDD: RED → GREEN → SURFACE → CLEAN+- At least 3 realistic QA scenarios+- Real manual-QA channels (HTTP call, tmux, browser)+- A binding verification gate that loops until the work is genuinely donediff --git a/packages/web/content/docs/ulw-loop.md b/packages/web/content/docs/ulw-loop.mdnew file mode 100644index 00000000..ebce1a96--- /dev/null+++ b/packages/web/content/docs/ulw-loop.md@@ -0,0 +1,15 @@+`$ulw-loop` is a self-referential development loop that runs until verified completion.++### How it works++The agent works continuously and emits `<promise>DONE</promise>` when it believes the task is complete, but that does NOT end the loop. An Oracle must verify the result first. The loop ends only after the system confirms Oracle verified it. If verification fails, it continues with the message: "Oracle verification failed. Continuing ULTRAWORK loop."++### Syntax++```bash+/ulw-loop "task description" [--completion-promise=TEXT] [--strategy=reset|continue]+```++### Limits++The iteration cap is 500 in ultrawork mode (100 in normal mode).diff --git a/packages/web/content/docs/ulw-plan.md b/packages/web/content/docs/ulw-plan.mdnew file mode 100644index 00000000..c6d8de55--- /dev/null+++ b/packages/web/content/docs/ulw-plan.md@@ -0,0 +1,13 @@+`$ulw-plan` is the strategic planning consultant (Prometheus). It turns an idea into a decision-complete work plan. It is a planner, NOT an implementer. When you say "do X" it produces a plan for X and never writes product code.++### The flow++1. Socratic interview+2. Parallel codebase exploration+3. Metis gap analysis+4. Writes the plan to `plans/<slug>.md`+5. Optional Momus high-accuracy review++### Output++Questions, research, and a work plan you can hand to [`$start-work`](./start-work.md).diff --git a/packages/web/lib/docs-content.generated.ts b/packages/web/lib/docs-content.generated.tsnew file mode 100644index 00000000..54b57d56--- /dev/null+++ b/packages/web/lib/docs-content.generated.ts@@ -0,0 +1,9 @@+// AUTO-GENERATED — do not edit. Run: node ./scripts/generate-docs-content.mjs+export const DOC_SOURCES: Record<string, string> = {+ "overview.md": "<p>LazyCodex is the lazy way to get <a href=\"https://github.com/code-yeongyu/oh-my-openagent\">oh-my-openagent</a> (OmO) up and running inside Codex. Think <a href=\"https://github.com/LazyVim/LazyVim\">LazyVim</a> for <a href=\"https://github.com/folke/lazy.nvim\">lazy.nvim</a>, but for Codex.</p>\n<h3>What you get</h3>\n<p>OmO is a full AI dev team in a harness. It gives you discipline agents (Sisyphus orchestrates Hephaestus, Oracle, and Librarian), parallel execution, multi-model routing, a skills system, hooks and lifecycle, and zero-config defaults. LazyCodex wraps the entire setup so you don't have to think about it.</p>\n<h3>The one-word workflow</h3>\n<p>You don't need to ultrathink. Just prompt with <code>{your prompt} ultrawork</code>. One word, and every agent activates.</p>\n<h3>How it fits together</h3>\n<p>LazyCodex is a thin distribution layer. The core engine is <a href=\"https://github.com/code-yeongyu/oh-my-openagent\">OmO</a>. LazyCodex is maintained by <a href=\"https://sisyphuslabs.ai\">Sisyphus Labs</a>.</p>\n<ul>\n<li><a href=\"https://github.com/code-yeongyu/lazycodex\">LazyCodex on GitHub</a></li>\n<li><a href=\"https://github.com/code-yeongyu/oh-my-openagent\">OmO on GitHub</a></li>\n</ul>\n",+ "installation.md": "<p>One command gets you running. LazyCodex is currently available on OpenCode; the Codex edition is coming June 2026.</p>\n<h3>Install</h3>\n<pre><code class=\"language-bash\">bunx lazycodex install\n</code></pre>\n<p>This is exactly equivalent to <code>bunx omo install --platform=codex</code>.</p>\n<h3>Autonomous one-liner</h3>\n<pre><code class=\"language-bash\">bunx lazycodex install --no-tui --codex-autonomous\n</code></pre>\n<h3>Prerequisites</h3>\n<ul>\n<li><a href=\"https://bun.sh\">Bun</a></li>\n<li>The <a href=\"https://github.com/openai/codex\">OpenAI Codex CLI</a></li>\n</ul>\n<blockquote>\n<p>Do NOT use <code>npm install -g</code> or <code>bun add -g</code>. Always invoke via <code>bunx</code>.</p>\n</blockquote>\n<h3>Let an agent do it</h3>\n<p>It is strongly recommended to let an LLM agent run the install and walk the setup for you. The agent handles subscription detection, model selection, and provider auth automatically.</p>\n",+ "ultrawork.md": "<p>ultrawork is the headline mode. Typing <code>ultrawork</code> (or the short alias <code>ulw</code>) anywhere in your prompt activates maximum-precision, outcome-first, evidence-driven orchestration.</p>\n<blockquote>\n<p>"One word. Every agent activates. Doesn't stop until done."</p>\n</blockquote>\n<h3>Usage</h3>\n<pre><code class=\"language-bash\">ulw add authentication\n</code></pre>\n<h3>What it enforces</h3>\n<ul>\n<li>Strict TDD: RED → GREEN → SURFACE → CLEAN</li>\n<li>At least 3 realistic QA scenarios</li>\n<li>Real manual-QA channels (HTTP call, tmux, browser)</li>\n<li>A binding verification gate that loops until the work is genuinely done</li>\n</ul>\n",+ "ulw-loop.md": "<p><code>$ulw-loop</code> is a self-referential development loop that runs until verified completion.</p>\n<h3>How it works</h3>\n<p>The agent works continuously and emits <code><promise>DONE</promise></code> when it believes the task is complete, but that does NOT end the loop. An Oracle must verify the result first. The loop ends only after the system confirms Oracle verified it. If verification fails, it continues with the message: "Oracle verification failed. Continuing ULTRAWORK loop."</p>\n<h3>Syntax</h3>\n<pre><code class=\"language-bash\">/ulw-loop "task description" [--completion-promise=TEXT] [--strategy=reset|continue]\n</code></pre>\n<h3>Limits</h3>\n<p>The iteration cap is 500 in ultrawork mode (100 in normal mode).</p>\n",+ "ulw-plan.md": "<p><code>$ulw-plan</code> is the strategic planning consultant (Prometheus). It turns an idea into a decision-complete work plan. It is a planner, NOT an implementer. When you say "do X" it produces a plan for X and never writes product code.</p>\n<h3>The flow</h3>\n<ol>\n<li>Socratic interview</li>\n<li>Parallel codebase exploration</li>\n<li>Metis gap analysis</li>\n<li>Writes the plan to <code>plans/<slug>.md</code></li>\n<li>Optional Momus high-accuracy review</li>\n</ol>\n<h3>Output</h3>\n<p>Questions, research, and a work plan you can hand to <a href=\"#start-work\"><code>$start-work</code></a>.</p>\n",+ "start-work.md": "<p><code>$start-work</code> executes a Prometheus work plan until every top-level checkbox is done.</p>\n<h3>How it works</h3>\n<ul>\n<li>Durable Boulder state in <code>.omo/boulder.json</code> survives across turns and sessions</li>\n<li>A Stop-hook re-injects the next turn until the plan is complete</li>\n<li>Independent sub-tasks fan out to parallel subagents</li>\n<li>Strict TDD plus five evidence gates: plan reread, automated verification, manual-QA, adversarial QA, cleanup</li>\n<li>Progress is recorded to a ledger</li>\n</ul>\n<h3>Syntax</h3>\n<pre><code class=\"language-bash\">/start-work [plan-name] [--worktree <absolute-path>]\n</code></pre>\n<h3>Done</h3>\n<p>It prints an <code>ORCHESTRATION COMPLETE</code> block when every checkbox is checked.</p>\n"+};diff --git a/packages/web/lib/docs-sections.ts b/packages/web/lib/docs-sections.tsnew file mode 100644index 00000000..eb1d6f89--- /dev/null+++ b/packages/web/lib/docs-sections.ts@@ -0,0 +1,24 @@+export type DocSectionId =+ | "overview"+ | "installation"+ | "ultrawork"+ | "ulw-loop"+ | "ulw-plan"+ | "start-work";++export type DocSection = {+ readonly id: DocSectionId;+ readonly file: string;+ readonly title: string;+};++export const DOC_SECTIONS: readonly DocSection[] = [+ { id: "overview", file: "overview.md", title: "Overview" },+ { id: "installation", file: "installation.md", title: "Installation" },+ { id: "ultrawork", file: "ultrawork.md", title: "ultrawork mode" },+ { id: "ulw-loop", file: "ulw-loop.md", title: "$ulw-loop" },+ { id: "ulw-plan", file: "ulw-plan.md", title: "$ulw-plan" },+ { id: "start-work", file: "start-work.md", title: "$start-work" },+] as const;++export const DOC_SECTION_IDS = DOC_SECTIONS.map((s) => s.id);diff --git a/packages/web/lib/docs-source.ts b/packages/web/lib/docs-source.tsnew file mode 100644index 00000000..de550fe3--- /dev/null+++ b/packages/web/lib/docs-source.ts@@ -0,0 +1,11 @@+import { DOC_SOURCES } from "./docs-content.generated";++export function loadDocSource(file: string): string {+ const source = DOC_SOURCES[file];+ if (source === undefined) {+ throw new Error(+ `Unknown doc file: ${file}. Run \`node ./scripts/generate-docs-content.mjs\` to regenerate docs content.`,+ );+ }+ return source;+}diff --git a/packages/web/package.json b/packages/web/package.jsonindex 38eaba54..aac5b125 100644--- a/packages/web/package.json+++ b/packages/web/package.json@@ -8,7 +8,9 @@"node": ">=22"},"scripts": {+ "predev": "node ./scripts/generate-docs-content.mjs","dev": "next dev",+ "prebuild": "node ./scripts/generate-docs-content.mjs","build": "NODE_OPTIONS=--no-deprecation next build","start": "NODE_OPTIONS=--no-deprecation next start","lint": "biome lint app e2e",@@ -35,6 +37,7 @@"@types/react": "^19.2.15","@types/react-dom": "^19.2.3","lighthouse": "^13.3.0",+ "marked": "^18.0.0","postcss": "^8.5.15","tailwindcss": "4.3.0","typescript": "^5.7.3",diff --git a/packages/web/pnpm-lock.yaml b/packages/web/pnpm-lock.yamlindex e9a6d5ec..6c0abed9 100644--- a/packages/web/pnpm-lock.yaml+++ b/packages/web/pnpm-lock.yaml@@ -45,6 +45,9 @@ importers:lighthouse:specifier: ^13.3.0version: 13.3.0+ marked:+ specifier: ^18.0.0+ version: 18.0.4postcss:specifier: ^8.5.15version: 8.5.15@@ -2336,6 +2339,11 @@ packages:resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}+ resolution: {integrity: sha512-c/BTaKzg0G6ezQx97DAkYU7k0HM6ys0FqYeKBL6hlBByZwy+ycA1+f0vDdjMHKKeEjdgkx0GOv9Il6D+85cOqA==}+ engines: {node: '>= 20'}+ hasBin: true+resolution: {integrity: sha512-ocnPZQLNpvbedwTy9kNrQEsknEfgvcLMvOtz3sFeWApDq1MXH1TqkCIx58xlpESsfwQOnuBO9beyQuNGzVvuhQ==}@@ -5605,6 +5613,8 @@ snapshots:dependencies:'@jridgewell/sourcemap-codec': 1.5.5+ [email protected]: {}+diff --git a/packages/web/scripts/generate-docs-content.mjs b/packages/web/scripts/generate-docs-content.mjsnew file mode 100644index 00000000..11ea7751--- /dev/null+++ b/packages/web/scripts/generate-docs-content.mjs@@ -0,0 +1,84 @@+// Build-time docs pipeline: compiles content/docs/*.md to HTML and emits a+// generated TS module. Run via package.json prebuild/predev, or directly:+// node ./scripts/generate-docs-content.mjs+import { readFile, writeFile } from "node:fs/promises";+import path from "node:path";+import { Marked } from "marked";++// Fixed, ordered section list. Key = output map key (the markdown file name).+const SECTIONS = [+ { id: "overview", file: "overview.md" },+ { id: "installation", file: "installation.md" },+ { id: "ultrawork", file: "ultrawork.md" },+ { id: "ulw-loop", file: "ulw-loop.md" },+ { id: "ulw-plan", file: "ulw-plan.md" },+ { id: "start-work", file: "start-work.md" },+];++const DOCS_ROOT = path.resolve(process.cwd(), "content", "docs");+const OUTPUT = path.resolve(process.cwd(), "lib", "docs-content.generated.ts");+const BANNER =+ "// AUTO-GENERATED — do not edit. Run: node ./scripts/generate-docs-content.mjs\n";++// Heading/anchor slug: lowercase, spaces to "-", drop everything that is not+// an alphanumeric or hyphen, then collapse/trim hyphens. Hyphens survive so+// multi-word section ids (ulw-loop, start-work) keep their anchors.+function slugify(value) {+ return value+ .toLowerCase()+ .trim()+ .replace(/\s+/g, "-")+ .replace(/[^a-z0-9-]/g, "")+ .replace(/-+/g, "-")+ .replace(/^-+|-+$/g, "");+}++// Rewrite cross-doc links (./foo.md or bare foo.md) into same-page hash+// anchors (#foo). External, absolute, and in-page (#...) links pass through.+function rewriteDocsLink(href) {+ if (!href) return href;+ const isRelative = href.startsWith("./");+ const isBareMarkdown = /^[^/#?:]+\.md(?:#.*)?$/i.test(href);+ if (!isRelative && !isBareMarkdown) return href;++ const withoutPrefix = href.replace(/^\.\//, "");+ const [pathPart] = withoutPrefix.split("#", 1);+ if (!pathPart) return href;+ const base = path.posix.basename(pathPart).replace(/\.md$/i, "");+ return `#${slugify(base)}`;+}++function createMarked() {+ const marked = new Marked({ gfm: true, breaks: false });+ marked.use({+ walkTokens(token) {+ if (token.type !== "link") return;+ token.href = rewriteDocsLink(token.href);+ },+ });+ return marked;+}++const sources = {};+for (const section of SECTIONS) {+ const markdown = await readFile(path.join(DOCS_ROOT, section.file), "utf8");+ // JSON.stringify (below) escapes backticks/${} safely — never template strings.+ sources[section.file] = await createMarked().parse(markdown);+}++const out = `${BANNER}export const DOC_SOURCES: Record<string, string> = ${JSON.stringify(sources, null, 2)};\n`;++async function outputIsCurrent(content) {+ try {+ return (await readFile(OUTPUT, "utf8")) === content;+ } catch {+ return false;+ }+}++if (await outputIsCurrent(out)) {+ process.stdout.write(`Docs content already current with ${SECTIONS.length} HTML-compiled docs\n`);+} else {+ await writeFile(OUTPUT, out);+ process.stdout.write(`Generated ${OUTPUT} with ${SECTIONS.length} HTML-compiled docs\n`);+}