Skip to content

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

feat(web): launch with live stars

YeonGyu-Kimed56855efe90
diff --git a/README.md b/README.md
index ae0e6022..f50bbfc1 100644
--- a/README.md
+++ b/README.md
@@ -21,31 +21,28 @@
</p>
<br />
-
- <p><strong>๐Ÿšง Coming June 2026 ยท Currently available for OpenCode</strong></p>
</div>
<hr />
## ๐Ÿš€ Install
-One line. No global install, no `npm i -g`. Always use `bunx`:
+One line. No global install, no `npm i -g`. Always use `npx`:
```bash
-bunx lazycodex-ai install
+npx lazycodex-ai install
```
-This is shorthand for `bunx --package oh-my-openagent omo install --platform=codex`. For a fully autonomous, no-TUI setup:
+This is shorthand for `npx --yes --package oh-my-openagent omo install --platform=codex`. For a fully autonomous, no-TUI setup:
```bash
-bunx lazycodex-ai install --no-tui --codex-autonomous
+npx lazycodex-ai install --no-tui --codex-autonomous
```
## โšก Commands
-LazyCodex installs these as OpenCode user custom commands. In OpenCode,
-custom commands are invoked with `$command`; `/command` is reserved for
-OpenCode's built-in slash commands.
+LazyCodex installs these as OmO commands for Codex. Invoke them with the
+`$command` syntax shown by the installer.
| Command | Type this | What it does |
| --- | --- | --- |
@@ -144,7 +141,7 @@ LazyCodex is maintained by **Jobdori**, the AI assistant that builds and ships [
[![Sisyphus Labs](.github/assets/sisyphuslabs.png)](https://sisyphuslabs.ai)
> **Meet your own Jobdori, Dori.**
-> **Join the waitlist at [sisyphuslabs.ai](https://sisyphuslabs.ai).**
+> **Learn more at [sisyphuslabs.ai](https://sisyphuslabs.ai).**
</div>
diff --git a/bin/lazycodex-ai.js b/bin/lazycodex-ai.js
index eb73ed90..186178d7 100755
--- a/bin/lazycodex-ai.js
+++ b/bin/lazycodex-ai.js
@@ -7,15 +7,23 @@ const dryRun = args[0] === "--dry-run"
const forwardedArgs = dryRun ? args.slice(1) : args
const commandArgs =
forwardedArgs[0] === "install"
- ? ["--package", "oh-my-openagent", "omo", "install", "--platform=codex", ...forwardedArgs.slice(1)]
- : ["--package", "oh-my-openagent", "omo", ...forwardedArgs]
+ ? [
+ "--yes",
+ "--package",
+ "oh-my-openagent",
+ "omo",
+ "install",
+ "--platform=codex",
+ ...forwardedArgs.slice(1),
+ ]
+ : ["--yes", "--package", "oh-my-openagent", "omo", ...forwardedArgs]
if (dryRun) {
- console.log(["bunx", ...commandArgs].join(" "))
+ console.log(["npx", ...commandArgs].join(" "))
process.exit(0)
}
-const result = spawnSync("bunx", commandArgs, {
+const result = spawnSync("npx", commandArgs, {
stdio: "inherit",
})
diff --git a/package.json b/package.json
index a101f440..dad70d64 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
{
"name": "lazycodex-ai",
"version": "0.2.1",
- "description": "Codex install alias for oh-my-openagent. Run `bunx lazycodex-ai install` to set up the Codex platform.",
+ "description": "Codex install alias for oh-my-openagent. Run `npx lazycodex-ai install` to set up the Codex platform.",
"type": "module",
"bin": {
"lazycodex-ai": "bin/lazycodex-ai.js"
@@ -12,7 +12,7 @@
"LICENSE"
],
"scripts": {
- "test": "node --test test/lazycodex-ai-bin.test.mjs",
+ "test": "node --test test/*.test.mjs",
"pack:dry-run": "npm pack --dry-run"
},
"keywords": [
diff --git a/packages/web/DESIGN.md b/packages/web/DESIGN.md
index 81c21678..ae12d761 100644
--- a/packages/web/DESIGN.md
+++ b/packages/web/DESIGN.md
@@ -26,7 +26,7 @@
## 4. Layout & Spacing
- **Canvas**: Full viewport (`min-h-[100dvh]`), flex column, centered.
- **Card**: Max width 1200px, aspect ratio 1200/630 on large screens. Rounded corners (`16px`).
-- **Outer Elements**: "OmO in Codex" (top-left) and "Coming June 2026" (bottom-right) are positioned absolutely on the canvas, outside the card, to preserve the card's exact visual match with the reference.
+- **Outer Elements**: The canvas may carry small co-brand labels outside the card when needed, but the current public landing page leads with installable Codex setup instead of launch timing.
## 5. Gradients & Effects
- **Base Gradient**: Radial gradient from `#5a5fef` to `#232897`.
@@ -70,9 +70,9 @@ The landing page is a single scrollable document with the following sections, to
- The `{your prompt}` placeholder uses Geist Mono and pulses subtly
3. **Install block**
- - Copyable bash snippet: `bunx lazycodex-ai install`
- - One-line note: "No global install. Always `bunx`."
- - Secondary line for the autonomous variant: `bunx lazycodex-ai install --no-tui --codex-autonomous`
+ - Copyable bash snippet: `npx lazycodex-ai install`
+ - One-line note: "No global install. Always `npx`."
+ - Secondary line for the autonomous variant: `npx lazycodex-ai install --no-tui --codex-autonomous`
4. **Three command cards**
- `$ulw-loop` โ€” self-referential loop
diff --git a/packages/web/app/api/github-stars/route.ts b/packages/web/app/api/github-stars/route.ts
new file mode 100644
index 00000000..971631aa
--- /dev/null
+++ b/packages/web/app/api/github-stars/route.ts
@@ -0,0 +1,44 @@
+import { NextResponse } from "next/server"
+import { fetchGitHubStars, type GitHubStarsData } from "../../../lib/github-stars"
+import { FALLBACK_GITHUB_STARS, formatStarsCount } from "../../../lib/github-stars-format"
+
+export const dynamic = "force-dynamic"
+export const revalidate = 60
+
+const LIVE_CACHE_CONTROL = "public, s-maxage=60, stale-while-revalidate=300"
+const FALLBACK_CACHE_CONTROL = "public, s-maxage=30, stale-while-revalidate=120"
+
+type GitHubStarsFallbackPayload = {
+ readonly stars: number
+ readonly formatted: string
+ readonly source: "fallback"
+}
+
+type GitHubStarsApiPayload = GitHubStarsData | GitHubStarsFallbackPayload
+
+function createStarsResponse(
+ payload: GitHubStarsApiPayload,
+ cacheControl: string,
+): NextResponse<GitHubStarsApiPayload> {
+ return NextResponse.json(payload, {
+ headers: {
+ "Cache-Control": cacheControl,
+ },
+ })
+}
+
+export async function GET(): Promise<NextResponse<GitHubStarsApiPayload>> {
+ try {
+ const data = await fetchGitHubStars()
+ return createStarsResponse(data, LIVE_CACHE_CONTROL)
+ } catch {
+ return createStarsResponse(
+ {
+ stars: FALLBACK_GITHUB_STARS,
+ formatted: formatStarsCount(FALLBACK_GITHUB_STARS),
+ source: "fallback",
+ },
+ FALLBACK_CACHE_CONTROL,
+ )
+ }
+}
diff --git a/packages/web/app/layout.tsx b/packages/web/app/layout.tsx
index bafeba82..2bc9b1a5 100644
--- a/packages/web/app/layout.tsx
+++ b/packages/web/app/layout.tsx
@@ -7,7 +7,7 @@ const SITE_URL = "https://lazycodex.ai"
const SITE_NAME = "LazyCodex"
const TAGLINE = "Codex for no-brainers"
const DESCRIPTION =
- "LazyCodex. You don't need to think. Just prompt with ultrawork. Coming June 2026. Currently on OpenCode."
+ "LazyCodex. You don't need to ultrathink. Just prompt with ultrawork and install the Codex agent harness in one command."
export const viewport: Viewport = {
width: "device-width",
@@ -19,7 +19,7 @@ export const viewport: Viewport = {
export const metadata: Metadata = {
metadataBase: new URL(SITE_URL),
title: {
- default: `${SITE_NAME} โ€” ${TAGLINE}. Coming June 2026.`,
+ default: `${SITE_NAME} โ€” ${TAGLINE}`,
template: `%s | ${SITE_NAME}`,
},
description: DESCRIPTION,
@@ -47,7 +47,7 @@ export const metadata: Metadata = {
locale: "en_US",
url: SITE_URL,
siteName: SITE_NAME,
- title: `${SITE_NAME} โ€” ${TAGLINE}. Coming June 2026.`,
+ title: `${SITE_NAME} โ€” ${TAGLINE}`,
description: DESCRIPTION,
// og:image supplied by app/opengraph-image.tsx (file-based convention).
},
@@ -93,8 +93,7 @@ const jsonLd = {
"@type": "Offer",
price: "0",
priceCurrency: "USD",
- availability: "https://schema.org/PreOrder",
- availabilityStarts: "2026-06-01",
+ availability: "https://schema.org/InStock",
},
potentialAction: {
"@type": "ViewAction",
diff --git a/packages/web/app/opengraph-image.tsx b/packages/web/app/opengraph-image.tsx
index a3547bee..a3a5b8a2 100644
--- a/packages/web/app/opengraph-image.tsx
+++ b/packages/web/app/opengraph-image.tsx
@@ -1,7 +1,7 @@
import { ImageResponse } from "next/og"
export const runtime = "nodejs"
-export const alt = "LazyCodex splash โ€” Codex for no-brainers. Coming June 2026."
+export const alt = "LazyCodex splash โ€” Codex for no-brainers."
export const size = { width: 1200, height: 630 }
export const contentType = "image/png"
@@ -82,7 +82,7 @@ export default function OgImage(): ImageResponse {
lineHeight: 1.35,
}}
>
- <div>You don't need to think.</div>
+ <div>You don't need to ultrathink.</div>
<div style={{ display: "flex" }}>
<span>Just prompt with&nbsp;</span>
<span style={{ color: palette.textPrimary, fontWeight: 500 }}>ultrawork</span>
diff --git a/packages/web/app/twitter-image.tsx b/packages/web/app/twitter-image.tsx
index 6f66f465..e82cbfae 100644
--- a/packages/web/app/twitter-image.tsx
+++ b/packages/web/app/twitter-image.tsx
@@ -7,6 +7,6 @@
export { default } from "./opengraph-image"
export const runtime = "nodejs"
-export const alt = "LazyCodex splash โ€” Codex for no-brainers. Coming June 2026."
+export const alt = "LazyCodex splash โ€” Codex for no-brainers."
export const size = { width: 1200, height: 630 }
export const contentType = "image/png"
diff --git a/packages/web/components/site/github-stars-pill.tsx b/packages/web/components/site/github-stars-pill.tsx
index 96a04295..326e6c92 100644
--- a/packages/web/components/site/github-stars-pill.tsx
+++ b/packages/web/components/site/github-stars-pill.tsx
@@ -1,15 +1,58 @@
+"use client"
+
import type { JSX } from "react"
+import { useEffect, useState } from "react"
+import { FALLBACK_GITHUB_STARS, formatStarsCount } from "../../lib/github-stars-format"
import { SITE_CONFIG } from "../../lib/site-config"
-import { GITHUB_STARS } from "../../lib/github-stars.generated"
+
+function readFormattedStars(payload: unknown): string | undefined {
+ if (typeof payload !== "object" || payload === null || !("formatted" in payload)) {
+ return undefined
+ }
+
+ const formatted = payload.formatted
+ if (typeof formatted !== "string" || formatted.trim().length === 0) {
+ return undefined
+ }
+
+ return formatted
+}
export function GithubStarsPill(): JSX.Element {
+ const [starsLabel, setStarsLabel] = useState(formatStarsCount(FALLBACK_GITHUB_STARS))
+
+ useEffect(() => {
+ let cancelled = false
+
+ async function refreshStars(): Promise<void> {
+ try {
+ const response = await fetch("/api/github-stars", { cache: "no-store" })
+ if (!response.ok || cancelled) return
+
+ const payload: unknown = await response.json()
+ const formatted = readFormattedStars(payload)
+ if (formatted === undefined || cancelled) return
+
+ setStarsLabel(formatted)
+ } catch {
+ return
+ }
+ }
+
+ void refreshStars()
+
+ return () => {
+ cancelled = true
+ }
+ }, [])
+
return (
<a
href={SITE_CONFIG.githubStarsUrl}
target="_blank"
rel="noopener noreferrer"
className="group flex h-8 items-center gap-1.5 rounded-full border border-[#172323] bg-[#0E1313] px-3 text-sm font-medium text-[color:var(--accent-cyan)] transition-colors hover:border-[color:var(--accent-teal)] hover:bg-[#131a1a] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent-cyan)]"
- aria-label={`${GITHUB_STARS} stars on GitHub`}
+ aria-label={`${starsLabel} stars on GitHub`}
>
<svg
xmlns="http://www.w3.org/2000/svg"
@@ -26,7 +69,7 @@ export function GithubStarsPill(): JSX.Element {
>
<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2" />
</svg>
- <span>{GITHUB_STARS} stars</span>
+ <span>{starsLabel} stars</span>
</a>
)
}
diff --git a/packages/web/content/docs/installation.md b/packages/web/content/docs/installation.md
index efc3fb9f..e8e1b07c 100644
--- a/packages/web/content/docs/installation.md
+++ b/packages/web/content/docs/installation.md
@@ -1,17 +1,17 @@
-One command gets you running. LazyCodex is currently available on OpenCode; the Codex edition is coming June 2026.
+One command gets you running. LazyCodex installs the Codex platform setup for OmO without a global package install.
### Install
```bash
-bunx lazycodex-ai install
+npx lazycodex-ai install
```
-This is exactly equivalent to `bunx --package oh-my-openagent omo install --platform=codex`.
+This is exactly equivalent to `npx --yes --package oh-my-openagent omo install --platform=codex`.
### Autonomous one-liner
```bash
-bunx lazycodex-ai install --no-tui --codex-autonomous
+npx lazycodex-ai install --no-tui --codex-autonomous
```
### Prerequisites
@@ -19,7 +19,7 @@ bunx lazycodex-ai install --no-tui --codex-autonomous
- [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`.
+> Do NOT use `npm install -g` or `bun add -g`. Always invoke via `npx`.
### Let an agent do it
diff --git a/packages/web/e2e/docs.spec.ts b/packages/web/e2e/docs.spec.ts
index 47470f5f..c6e1faf0 100644
--- a/packages/web/e2e/docs.spec.ts
+++ b/packages/web/e2e/docs.spec.ts
@@ -1,4 +1,4 @@
-import { test, expect } from "@playwright/test"
+import { expect, test } from "@playwright/test"
import { DOC_SECTIONS } from "../lib/docs-sections"
/**
@@ -45,15 +45,17 @@ test.describe("docs page โ€” structure", () => {
test("documents lazycodex-ai as the npm install alias", async ({ page }) => {
await page.goto("/docs")
- await expect(page.getByText("bunx lazycodex-ai install", { exact: false }).first()).toBeVisible()
+ await expect(page.getByText("npx lazycodex-ai install", { exact: false }).first()).toBeVisible()
await expect(
page
- .getByText("bunx lazycodex-ai install --no-tui --codex-autonomous", { exact: false })
+ .getByText("npx lazycodex-ai install --no-tui --codex-autonomous", { exact: false })
.first(),
).toBeVisible()
await expect(
page
- .getByText("bunx --package oh-my-openagent omo install --platform=codex", { exact: false })
+ .getByText("npx --yes --package oh-my-openagent omo install --platform=codex", {
+ exact: false,
+ })
.first(),
).toBeVisible()
})
diff --git a/packages/web/e2e/github-stars.spec.ts b/packages/web/e2e/github-stars.spec.ts
new file mode 100644
index 00000000..92cd0b96
--- /dev/null
+++ b/packages/web/e2e/github-stars.spec.ts
@@ -0,0 +1,88 @@
+import { expect, test } from "@playwright/test"
+import {
+ fetchGitHubStars,
+ parseShieldsStarsPayload,
+} from "../lib/github-stars"
+
+function restoreEnvVar(name: string, value: string | undefined): void {
+ if (value === undefined) {
+ delete process.env[name]
+ return
+ }
+
+ process.env[name] = value
+}
+
+test.describe("github stars API", () => {
+ test("responds with a numeric live star count", async ({ request }) => {
+ const response = await request.get("/api/github-stars")
+
+ expect(response.status()).toBe(200)
+
+ const body = await response.json()
+ expect(typeof body.stars).toBe("number")
+ expect(body.stars).toBeGreaterThan(0)
+ expect(typeof body.formatted).toBe("string")
+ expect(body.formatted.length).toBeGreaterThan(0)
+ expect(["github", "shields"]).toContain(body.source)
+ expect(body.source).not.toBe("fallback")
+ })
+})
+
+test.describe("github stars live source parsing", () => {
+ test("uses GH_TOKEN when GITHUB_TOKEN is absent", async () => {
+ const originalFetch = globalThis.fetch
+ const originalGitHubToken = process.env.GITHUB_TOKEN
+ const originalGhToken = process.env.GH_TOKEN
+ const authorizationHeaders: string[] = []
+
+ globalThis.fetch = async (_input, init) => {
+ authorizationHeaders.push(new Headers(init?.headers).get("Authorization") ?? "")
+ return Response.json({ stargazers_count: 321 })
+ }
+
+ try {
+ delete process.env.GITHUB_TOKEN
+ process.env.GH_TOKEN = "ghp_live"
+
+ const stars = await fetchGitHubStars()
+
+ expect(stars).toEqual({ stars: 321, formatted: "321", source: "github" })
+ expect(authorizationHeaders).toEqual(["Bearer ghp_live"])
+ } finally {
+ globalThis.fetch = originalFetch
+ restoreEnvVar("GITHUB_TOKEN", originalGitHubToken)
+ restoreEnvVar("GH_TOKEN", originalGhToken)
+ }
+ })
+
+ test("falls back to Shields when GitHub rejects the request", async () => {
+ const originalFetch = globalThis.fetch
+ const requestedUrls: string[] = []
+
+ globalThis.fetch = async (input, _init) => {
+ requestedUrls.push(String(input))
+ if (requestedUrls.length === 1) {
+ return new Response("rate limited", { status: 403 })
+ }
+
+ return Response.json({ message: "1.2k" })
+ }
+
+ try {
+ const stars = await fetchGitHubStars()
+
+ expect(stars).toEqual({ stars: 1_200, formatted: "1.2k", source: "shields" })
+ expect(requestedUrls[0]).toContain("api.github.com")
+ expect(requestedUrls[1]).toContain("img.shields.io")
+ } finally {
+ globalThis.fetch = originalFetch
+ }
+ })
+
+ test("parses Shields comma and compact star payloads", () => {
+ expect(parseShieldsStarsPayload({ value: "1,234" })).toBe(1_234)
+ expect(parseShieldsStarsPayload({ message: "2.5k" })).toBe(2_500)
+ expect(parseShieldsStarsPayload({ message: "invalid" })).toBeUndefined()
+ })
+})
diff --git a/packages/web/e2e/coming-soon.spec.ts b/packages/web/e2e/home.spec.ts
similarity index 71%
rename from packages/web/e2e/coming-soon.spec.ts
rename to packages/web/e2e/home.spec.ts
index 46714ac8..df8777b2 100644
--- a/packages/web/e2e/coming-soon.spec.ts
+++ b/packages/web/e2e/home.spec.ts
@@ -1,7 +1,19 @@
-import { test, expect } from "@playwright/test"
+import { expect, test } from "@playwright/test"
import { SITE_CONFIG } from "../lib/site-config"
-test.describe("coming-soon page โ€” content", () => {
+const LAUNCH_GATING_PATTERN = new RegExp(
+ [
+ ["coming", "soon"],
+ ["coming", "june"],
+ ["codex", "edition", "is", "coming"],
+ ["currently", "available", "for", "opencode"],
+ ]
+ .map((parts) => parts.join("\\s+"))
+ .join("|"),
+ "i",
+)
+
+test.describe("home page โ€” content", () => {
test("renders the wordmark, hero copy, and footer", async ({ page }) => {
await page.goto("/")
@@ -23,6 +35,13 @@ test.describe("coming-soon page โ€” content", () => {
await expect(page.getByText("lazycodex.ai", { exact: false }).first()).toBeVisible()
})
+ test("does not show launch gating copy", async ({ page }) => {
+ await page.goto("/")
+ const visibleText = await page.locator("body").innerText()
+
+ expect(visibleText).not.toMatch(LAUNCH_GATING_PATTERN)
+ })
+
test("has a single h1 and no broken landmarks", async ({ page }) => {
await page.goto("/")
const h1s = await page.locator("h1").count()
diff --git a/packages/web/e2e/landing.spec.ts b/packages/web/e2e/landing.spec.ts
index 88efbe90..c68d360b 100644
--- a/packages/web/e2e/landing.spec.ts
+++ b/packages/web/e2e/landing.spec.ts
@@ -1,6 +1,6 @@
-import { test, expect } from "@playwright/test"
-import { SITE_CONFIG } from "../lib/site-config"
+import { expect, test } from "@playwright/test"
import { COMMANDS } from "../lib/commands"
+import { SITE_CONFIG } from "../lib/site-config"
/**
* Landing `/` contract (TDD target state).
@@ -41,7 +41,7 @@ test.describe("landing page โ€” install + commands", () => {
await expect(
page.getByText(SITE_CONFIG.installCommand, { exact: false }).first(),
).toBeVisible()
- await expect(page.getByText("bunx lazycodex-ai install", { exact: false }).first()).toBeVisible()
+ await expect(page.getByText("npx lazycodex-ai install", { exact: false }).first()).toBeVisible()
await expect(page.getByText(SITE_CONFIG.installEquivalent, { exact: false }).first()).toBeVisible()
await expect(page.getByRole("button", { name: /copy/i }).first()).toBeVisible()
})
@@ -64,6 +64,14 @@ test.describe("landing page โ€” links + footer", () => {
await expect(stars).toContainText(/\d/)
})
+ test("updates the github stars pill from the live API", async ({ page }) => {
+ await page.goto("/")
+
+ const stars = page.locator(`a[href="${SITE_CONFIG.githubStarsUrl}"]`).first()
+ await expect(stars).toContainText(/^\d+(?:\.\d+[kM])?\sstars$/)
+ await expect(stars).toHaveAttribute("aria-label", /\d+(?:\.\d+[kM])?\sstars on GitHub/)
+ })
+
test("has a Docs link pointing at /docs", async ({ page }) => {
await page.goto("/")
const docs = page.getByRole("link", { name: /docs/i }).first()
diff --git a/packages/web/e2e/seo.spec.ts b/packages/web/e2e/seo.spec.ts
index 2cc1bd8f..61de5d90 100644
--- a/packages/web/e2e/seo.spec.ts
+++ b/packages/web/e2e/seo.spec.ts
@@ -1,4 +1,15 @@
-import { test, expect } from "@playwright/test"
+import { expect, test } from "@playwright/test"
+
+const LAUNCH_GATING_PATTERN = new RegExp(
+ [
+ ["coming", "soon"],
+ ["coming", "june"],
+ ["currently", "available", "for", "opencode"],
+ ]
+ .map((parts) => parts.join("\\s+"))
+ .join("|"),
+ "i",
+)
function readPngDimensions(buffer: Buffer): { width: number; height: number } {
const pngSignature = "89504e470d0a1a0a"
@@ -10,18 +21,18 @@ function readPngDimensions(buffer: Buffer): { width: number; height: number } {
}
}
-test.describe("coming-soon page โ€” SEO + metadata", () => {
+test.describe("site SEO + metadata", () => {
test("has a unique <title>, description, canonical, lang, viewport", async ({ page }) => {
await page.goto("/")
- await expect(page).toHaveTitle(/LazyCodex.*Coming June 2026/i)
+ await expect(page).toHaveTitle(/LazyCodex.*Codex/i)
const description = await page.locator('meta[name="description"]').getAttribute("content")
expect(description).toBeTruthy()
expect(description?.length).toBeGreaterThan(50)
expect(description?.length).toBeLessThanOrEqual(170)
- expect(description).toMatch(/OpenCode/i)
- expect(description).toMatch(/June 2026/i)
+ expect(description).toMatch(/Codex/i)
+ expect(description).not.toMatch(LAUNCH_GATING_PATTERN)
const canonical = await page.locator('link[rel="canonical"]').getAttribute("href")
// Next.js metadataBase + canonical: "/" can resolve to either with or
@@ -45,7 +56,7 @@ test.describe("coming-soon page โ€” SEO + metadata", () => {
)
await expect(page.locator('meta[property="og:description"]')).toHaveAttribute(
"content",
- /OpenCode/,
+ /Codex/,
)
await expect(page.locator('meta[property="og:type"]')).toHaveAttribute("content", "website")
await expect(page.locator('meta[property="og:url"]')).toHaveAttribute(
diff --git a/packages/web/lib/docs-content.generated.ts b/packages/web/lib/docs-content.generated.ts
index c07e05af..3a59930d 100644
--- a/packages/web/lib/docs-content.generated.ts
+++ b/packages/web/lib/docs-content.generated.ts
@@ -1,7 +1,7 @@
// 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&#39;t have to think about it.</p>\n<h3>The one-word workflow</h3>\n<p>You don&#39;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-ai install\n</code></pre>\n<p>This is exactly equivalent to <code>bunx --package oh-my-openagent omo install --platform=codex</code>.</p>\n<h3>Autonomous one-liner</h3>\n<pre><code class=\"language-bash\">bunx lazycodex-ai 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",
+ "installation.md": "<p>One command gets you running. LazyCodex installs the Codex platform setup for OmO without a global package install.</p>\n<h3>Install</h3>\n<pre><code class=\"language-bash\">npx lazycodex-ai install\n</code></pre>\n<p>This is exactly equivalent to <code>npx --yes --package oh-my-openagent omo install --platform=codex</code>.</p>\n<h3>Autonomous one-liner</h3>\n<pre><code class=\"language-bash\">npx lazycodex-ai 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>npx</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>&quot;One word. Every agent activates. Doesn&#39;t stop until done.&quot;</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>&lt;promise&gt;DONE&lt;/promise&gt;</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: &quot;Oracle verification failed. Continuing ULTRAWORK loop.&quot;</p>\n<h3>Syntax</h3>\n<pre><code class=\"language-bash\">/ulw-loop &quot;task description&quot; [--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 &quot;do X&quot; 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/&lt;slug&gt;.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",
diff --git a/packages/web/lib/github-stars-format.ts b/packages/web/lib/github-stars-format.ts
new file mode 100644
index 00000000..bbeeb2e3
--- /dev/null
+++ b/packages/web/lib/github-stars-format.ts
@@ -0,0 +1,15 @@
+export const FALLBACK_GITHUB_STARS = 0
+
+export function formatStarsCount(stars: number): string {
+ if (stars >= 1_000_000) {
+ const formatted = (stars / 1_000_000).toFixed(1)
+ return `${formatted.replace(/\.0$/, "")}M`
+ }
+
+ if (stars >= 1_000) {
+ const formatted = (stars / 1_000).toFixed(1)
+ return `${formatted.replace(/\.0$/, "")}k`
+ }
+
+ return String(stars)
+}
diff --git a/packages/web/lib/github-stars.generated.ts b/packages/web/lib/github-stars.generated.ts
deleted file mode 100644
index d0f1b365..00000000
--- a/packages/web/lib/github-stars.generated.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export const GITHUB_STARS: number = 48;
-export const GITHUB_STARS_FALLBACK: number = 0;
diff --git a/packages/web/lib/github-stars.ts b/packages/web/lib/github-stars.ts
new file mode 100644
index 00000000..f2014bf2
--- /dev/null
+++ b/packages/web/lib/github-stars.ts
@@ -0,0 +1,157 @@
+import { formatStarsCount } from "./github-stars-format"
+
+const GITHUB_API_BASE = "https://api.github.com"
+const GITHUB_OWNER = "code-yeongyu"
+const GITHUB_REPO = "lazycodex"
+const GITHUB_STARS_TIMEOUT_MS = 5_000
+const SHIELDS_STARS_URL = `https://img.shields.io/github/stars/${GITHUB_OWNER}/${GITHUB_REPO}.json`
+
+export type GitHubStarsSource = "github" | "shields"
+
+export type GitHubStarsData = {
+ readonly stars: number
+ readonly formatted: string
+ readonly source: GitHubStarsSource
+}
+
+class GitHubStarsFetchError extends Error {
+ readonly name = "GitHubStarsFetchError"
+
+ constructor(
+ readonly source: GitHubStarsSource,
+ readonly status: number,
+ ) {
+ super(`${source} stars request failed with status ${status}`)
+ }
+}
+
+class GitHubStarsPayloadError extends Error {
+ readonly name = "GitHubStarsPayloadError"
+
+ constructor(readonly source: GitHubStarsSource) {
+ super(`${source} stars response did not include a parseable star count`)
+ }
+}
+
+export function parseGitHubStarsPayload(payload: unknown): number | undefined {
+ if (typeof payload !== "object" || payload === null || !("stargazers_count" in payload)) {
+ return undefined
+ }
+
+ const stars = payload.stargazers_count
+ if (typeof stars !== "number" || !Number.isFinite(stars) || stars < 0) {
+ return undefined
+ }
+
+ return Math.floor(stars)
+}
+
+function parseStarsText(value: string): number | undefined {
+ const normalized = value.trim().replaceAll(",", "")
+ const match = /^(\d+(?:\.\d+)?)([kKmM])?$/.exec(normalized)
+ if (!match) return undefined
+
+ const [, amountText, suffix] = match
+ const amount = Number(amountText)
+ if (!Number.isFinite(amount) || amount < 0) return undefined
+
+ if (suffix?.toLowerCase() === "m") {
+ return Math.round(amount * 1_000_000)
+ }
+
+ if (suffix?.toLowerCase() === "k") {
+ return Math.round(amount * 1_000)
+ }
+
+ return Math.floor(amount)
+}
+
+function parseStarsValue(value: unknown): number | undefined {
+ if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+ return Math.floor(value)
+ }
+
+ if (typeof value === "string") {
+ return parseStarsText(value)
+ }
+
+ return undefined
+}
+
+export function parseShieldsStarsPayload(payload: unknown): number | undefined {
+ if (typeof payload !== "object" || payload === null) {
+ return undefined
+ }
+
+ if ("value" in payload) {
+ const valueStars = parseStarsValue(payload.value)
+ if (valueStars !== undefined) return valueStars
+ }
+
+ if ("message" in payload) {
+ return parseStarsValue(payload.message)
+ }
+
+ return undefined
+}
+
+function createGitHubHeaders(): HeadersInit {
+ const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN
+
+ return {
+ Accept: "application/vnd.github+json",
+ ...(token ? { Authorization: `Bearer ${token}` } : {}),
+ "User-Agent": "lazycodex-web",
+ "X-GitHub-Api-Version": "2022-11-28",
+ }
+}
+
+async function fetchJson(source: GitHubStarsSource, url: string, headers?: HeadersInit): Promise<unknown> {
+ const response = await fetch(url, {
+ ...(headers ? { headers } : {}),
+ signal: AbortSignal.timeout(GITHUB_STARS_TIMEOUT_MS),
+ })
+
+ if (!response.ok) {
+ throw new GitHubStarsFetchError(source, response.status)
+ }
+
+ return response.json()
+}
+
+async function fetchGitHubApiStars(): Promise<GitHubStarsData> {
+ const url = `${GITHUB_API_BASE}/repos/${GITHUB_OWNER}/${GITHUB_REPO}`
+ const payload = await fetchJson("github", url, createGitHubHeaders())
+ const stars = parseGitHubStarsPayload(payload)
+ if (stars === undefined) {
+ throw new GitHubStarsPayloadError("github")
+ }
+
+ return {
+ stars,
+ formatted: formatStarsCount(stars),
+ source: "github",
+ }
+}
+
+async function fetchShieldsStars(): Promise<GitHubStarsData> {
+ const payload = await fetchJson("shields", SHIELDS_STARS_URL)
+ const stars = parseShieldsStarsPayload(payload)
+ if (stars === undefined) {
+ throw new GitHubStarsPayloadError("shields")
+ }
+
+ return {
+ stars,
+ formatted: formatStarsCount(stars),
+ source: "shields",
+ }
+}
+
+export async function fetchGitHubStars(): Promise<GitHubStarsData> {
+ try {
+ return await fetchGitHubApiStars()
+ } catch {
+ return fetchShieldsStars()
+ }
+}
diff --git a/packages/web/lib/site-config.ts b/packages/web/lib/site-config.ts
index 91e86f49..985804c8 100644
--- a/packages/web/lib/site-config.ts
+++ b/packages/web/lib/site-config.ts
@@ -1,7 +1,7 @@
export const SITE_CONFIG = {
- installCommand: "bunx lazycodex-ai install",
- installCommandAutonomous: "bunx lazycodex-ai install --no-tui --codex-autonomous",
- installEquivalent: "bunx --package oh-my-openagent omo install --platform=codex",
+ installCommand: "npx lazycodex-ai install",
+ installCommandAutonomous: "npx lazycodex-ai install --no-tui --codex-autonomous",
+ installEquivalent: "npx --yes --package oh-my-openagent omo install --platform=codex",
githubUrl: "https://github.com/code-yeongyu/lazycodex",
githubStarsUrl: "https://github.com/code-yeongyu/lazycodex/stargazers",
omoUrl: "https://github.com/code-yeongyu/oh-my-openagent",
diff --git a/plugins/omo/components/comment-checker/README.md b/plugins/omo/components/comment-checker/README.md
index d48d38f8..9d3293d6 100644
--- a/plugins/omo/components/comment-checker/README.md
+++ b/plugins/omo/components/comment-checker/README.md
@@ -52,7 +52,7 @@ node dist/cli.js hook post-tool-use < test/fixtures/post-tool-use.json
## Local Codex Installation
```bash
-bunx lazycodex install
+npx lazycodex-ai install
```
The installer builds and copies the plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/0.1.0`, registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository, installs runtime dependencies there, and enables:
diff --git a/plugins/omo/components/lsp/README.md b/plugins/omo/components/lsp/README.md
index a449ef99..237e8f4f 100644
--- a/plugins/omo/components/lsp/README.md
+++ b/plugins/omo/components/lsp/README.md
@@ -119,7 +119,7 @@ printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/cli.j
## Local Codex Installation
```bash
-bunx lazycodex install
+npx lazycodex-ai install
```
The installer builds and copies the plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/0.1.0`, registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository, and enables:
diff --git a/plugins/omo/components/rules/README.md b/plugins/omo/components/rules/README.md
index c7a40dab..1cab797a 100644
--- a/plugins/omo/components/rules/README.md
+++ b/plugins/omo/components/rules/README.md
@@ -43,7 +43,7 @@ Prefer strict TypeScript and keep runtime imports ESM-compatible.
## Install Locally
```bash
-bunx lazycodex install
+npx lazycodex-ai install
```
The local installer builds the plugin and copies a clean cache entry to:
diff --git a/plugins/omo/components/rules/bundled-rules/hephaestus.md b/plugins/omo/components/rules/bundled-rules/hephaestus.md
index 556d2bd8..345b5e02 100644
--- a/plugins/omo/components/rules/bundled-rules/hephaestus.md
+++ b/plugins/omo/components/rules/bundled-rules/hephaestus.md
@@ -158,7 +158,7 @@ AGENTS.md files in your context carry directory-scoped conventions. Obey them fo
- Multi-line code in fenced blocks with a language tag.
- The user does not see command outputs - summarize the key lines when reporting them.
- No emojis or em dashes unless the user explicitly requests them.
-- Never output broken inline citations like `ใ€F:README.mdโ€ L5-L14ใ€‘` - they break the CLI.
+- Never output broken inline citations like `[F:README.md L5-L14]` - they break the CLI.
# Success Criteria
diff --git a/plugins/omo/components/ultragoal/README.md b/plugins/omo/components/ultragoal/README.md
index d783ab30..dbd562dc 100644
--- a/plugins/omo/components/ultragoal/README.md
+++ b/plugins/omo/components/ultragoal/README.md
@@ -47,7 +47,7 @@ npm pack --dry-run
## Local Codex Installation
```bash
-bunx lazycodex install
+npx lazycodex-ai install
```
The installer builds and copies the plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/0.1.0`, registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository, installs runtime dependencies there, and enables:
diff --git a/plugins/omo/components/ultrawork/README.md b/plugins/omo/components/ultrawork/README.md
index 8a4a022b..420ea31e 100644
--- a/plugins/omo/components/ultrawork/README.md
+++ b/plugins/omo/components/ultrawork/README.md
@@ -20,7 +20,7 @@ The directive is currently 11,005 chars / 232 lines and follows the GPT-5.5 prom
## Install (via this marketplace)
```bash
-bunx lazycodex install
+npx lazycodex-ai install
```
The installer copies the plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/0.1.0`, registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository, enables `omo@sisyphuslabs` in `~/.codex/config.toml`, registers the `UserPromptSubmit` hook, and installs the bundled agent TOMLs into `~/.codex/agents/` (symlinks on Unix, copies on Windows). A manifest at `<plugin-cache>/.installed-agents.json` records the installed paths for clean uninstall.
@@ -48,7 +48,7 @@ Expect `<ultrawork-mode>` ... directive body.
## Agent role smoke test
-Run `bunx omo install --platform=codex`, then inspect `~/.codex/agents/`. On Linux / macOS you should see symlinks; on Windows you should see file copies. Each TOML should declare a non-empty `name`, `description`, and `developer_instructions`.
+Run `npx --yes --package oh-my-openagent omo install --platform=codex`, then inspect `~/.codex/agents/`. On Linux / macOS you should see symlinks; on Windows you should see file copies. Each TOML should declare a non-empty `name`, `description`, and `developer_instructions`.
## License
diff --git a/plugins/omo/components/ultrawork/hooks/ultrawork-detector.py b/plugins/omo/components/ultrawork/hooks/ultrawork-detector.py
index 413dd04d..45623a9f 100755
--- a/plugins/omo/components/ultrawork/hooks/ultrawork-detector.py
+++ b/plugins/omo/components/ultrawork/hooks/ultrawork-detector.py
@@ -182,11 +182,11 @@ but NEVER parallelise RED and GREEN of the same criterion.
# Verification gate (TRIGGERED, NOT OPTIONAL)
Trigger when ANY apply:
-- User said "์—„๋ฐ€", "strictly", "rigorously", "properly review", or
+- User said "strictly", "rigorously", "properly review", or
explicitly demanded review.
- Task touches 3+ files OR ran 20+ turns OR 30+ minutes wall-clock.
- Refactor, migration, performance change, security-sensitive work, or
- anything the user called "๊นŠ๊ฒŒ" / "deeply".
+ anything the user called "deeply".
Procedure (NON-NEGOTIABLE):
1. Spawn agent_type `codex-ultrawork-reviewer` (or any `gpt-5.2`
diff --git a/plugins/omo/skills/debugging/SKILL.md b/plugins/omo/skills/debugging/SKILL.md
index 9aacfa3e..0d77c604 100644
--- a/plugins/omo/skills/debugging/SKILL.md
+++ b/plugins/omo/skills/debugging/SKILL.md
@@ -1,6 +1,6 @@
---
name: debugging
-description: "MUST USE for any real runtime debugging across ANY language or binary โ€” crashes, silent failures, wrong responses, stuck processes, memory leaks, async misbehavior, unexplained timing, reverse engineering. Runs a hypothesis-driven loop: form โ‰ฅ3 hypotheses, investigate in parallel, after 2 failed rounds spawn Oracles from orthogonal angles, confirm root cause, lock with a failing test, fix minimally, QA by actually USING the system, scrub artifacts. The actual HOW lives in `references/` โ€” READ THEM. Triggers: 'debug this', 'why is X not working', 'hanging', 'attach a debugger', 'reverse engineer', 'pwndbg', 'gdb', 'lldb', 'node inspect', 'tsx debug', 'pdb', 'dlv', 'delve', 'rust-gdb', 'set a breakpoint', 'context ํ„ฐ์ง„๋‹ค', '์™œ ์‘๋‹ต์ด ๋น„์–ด', '๋””๋ฒ„๊ฑฐ ๋ถ™์—ฌ์„œ', '๋””๋ฒ„๊น…ํ•ด๋ด', '์ด๊ฑฐ ์™œ ์ด๋ž˜', 'trace this bug', 'reproduce and fix', 'silent failure', 'HTTP 200 but empty', '์™œ ๋ฉˆ์ถฐ', '๋ฐ”์ด๋„ˆ๋ฆฌ ๊นŒ๋ด', '๋ฆฌ๋ฒ„์‹ฑ', 'ํ”Œ๋ ˆ์ด๋ผ์ดํŠธ'."
+description: "MUST USE for any real runtime debugging across ANY language or binary โ€” crashes, silent failures, wrong responses, stuck processes, memory leaks, async misbehavior, unexplained timing, reverse engineering. Runs a hypothesis-driven loop: form โ‰ฅ3 hypotheses, investigate in parallel, after 2 failed rounds spawn Oracles from orthogonal angles, confirm root cause, lock with a failing test, fix minimally, QA by actually USING the system, scrub artifacts. The actual HOW lives in `references/` โ€” READ THEM. Triggers: 'debug this', 'why is X not working', 'hanging', 'attach a debugger', 'reverse engineer', 'pwndbg', 'gdb', 'lldb', 'node inspect', 'tsx debug', 'pdb', 'dlv', 'delve', 'rust-gdb', 'set a breakpoint', 'trace this bug', 'reproduce and fix', 'silent failure', 'HTTP 200 but empty', 'stuck process', 'inspect binary', 'reverse engineer', 'playwright failure'."
---
# Debugging
diff --git a/plugins/omo/skills/programming/SKILL.md b/plugins/omo/skills/programming/SKILL.md
index 1bb0f79d..55129171 100644
--- a/plugins/omo/skills/programming/SKILL.md
+++ b/plugins/omo/skills/programming/SKILL.md
@@ -176,7 +176,7 @@ A bare default constructor for any of these (no timeouts, no pool tuning, no sch
| UB / soundness gate | (n/a) | **nightly miri** with strict provenance + Tree Borrows pass | (n/a) | **`nilaway`** + `-race` detector + `goleak` are the equivalent gate |
| Disposable scripts | **PEP 723** inline metadata + `uv run script.py` | **rust-script** with inline `Cargo.toml` block | `bun run script.ts` | `//go:build ignore` + `go run script.go` |
| Bootstrap a new project | `scripts/python/new-project.py` | `scripts/rust/new-project.py` | `scripts/typescript/new-project.ts` | `scripts/go/new-project.py` |
-| Pre-commit / CI gate | `ruff check . && basedpyright && pytest` | `cargo +nightly clippy -- -D warnings && cargo nextest run && cargo +nightly miri test` | `bunx biome check . && bunx tsc --noEmit && bun test` | `gofumpt -l . && golangci-lint run ./... && nilaway ./... && go test -race -shuffle=on -count=1 ./...` |
+| Pre-commit / CI gate | `ruff check . && basedpyright && pytest` | `cargo +nightly clippy -- -D warnings && cargo nextest run && cargo +nightly miri test` | `npx biome check . && npx tsc --noEmit && bun test` | `gofumpt -l . && golangci-lint run ./... && nilaway ./... && go test -race -shuffle=on -count=1 ./...` |
A `tsconfig.json` with `"strict": true` alone is **not** strict. The reference enumerates the additional flags. Same for `pyproject.toml` and `Cargo.toml` - the references contain the canonical full configuration.
diff --git a/plugins/omo/skills/programming/references/go/bubbletea-v2.md b/plugins/omo/skills/programming/references/go/bubbletea-v2.md
index 6e8f44eb..f0c20de3 100644
--- a/plugins/omo/skills/programming/references/go/bubbletea-v2.md
+++ b/plugins/omo/skills/programming/references/go/bubbletea-v2.md
@@ -10,7 +10,7 @@ The reference implementation this document is distilled from: [`code-yeongyu/bub
Bubbletea v1 manages cursor positioning in software ("virtual cursor"). It draws a `โ–ˆ` at the cursor position. The terminal's *real* cursor stays at `(0, 0)`.
-This breaks every CJK input method. IME candidate windows (the popup showing ๊ฐ€/๊ฐ/๊ฐ„ for Korean Hangul composition, kana โ†’ kanji for Japanese, pinyin lookup for Chinese) anchor to the terminal's **real** cursor position. With v1, the candidate window appears at top-left while you are typing somewhere in the middle of the screen.
+This breaks every CJK input method. IME candidate windows (the popup showing composed Hangul syllables, kana to kanji conversion, or pinyin lookup) anchor to the terminal's **real** cursor position. With v1, the candidate window appears at top-left while you are typing somewhere in the middle of the screen.
Bubbletea v2 fixes this with two changes:
@@ -143,7 +143,7 @@ for _, r := range s {
}
```
-`lipgloss/v2` uses `go-runewidth` internally โ€” `lipgloss.Width("์•ˆ๋…•")` returns 4, not 2. **If you measure outside lipgloss, you must call runewidth directly.**
+`lipgloss/v2` uses `go-runewidth` internally โ€” wide CJK text returns display-cell width, not rune count. **If you measure outside lipgloss, you must call runewidth directly.**
---
@@ -203,7 +203,7 @@ titleStyle := lipgloss.NewStyle().
Border(lipgloss.RoundedBorder()).
BorderForeground(lipgloss.Color("63"))
-rendered := titleStyle.Render("์•ˆ๋…•ํ•˜์„ธ์š”")
+rendered := titleStyle.Render("CJK title")
```
`lipgloss/v2` width and padding correctly account for CJK display width. v1 did too โ€” this is not a v2-specific fix, just a reminder.
@@ -297,18 +297,18 @@ internal/ui/
```go
import "charm.land/bubbletea/v2/teatest"
-func TestModel_typing_korean_keeps_cursor_in_position(t *testing.T) {
+func TestModel_typing_wide_text_keeps_cursor_in_position(t *testing.T) {
// Given
m := initial()
tm := teatest.NewTestModel(t, m, teatest.WithInitialTermSize(80, 24))
- // When โ€” simulate typing "์•ˆ๋…•"
- tm.Send(tea.KeyPressMsg{Code: '์•ˆ'})
- tm.Send(tea.KeyPressMsg{Code: '๋…•'})
+ // When โ€” simulate typing two wide characters
+ tm.Send(tea.KeyPressMsg{Code: 'ๅฅฝ'})
+ tm.Send(tea.KeyPressMsg{Code: 'ๅญ—'})
// Then
out := tm.FinalOutput(t)
- require.Contains(t, string(out), "์•ˆ๋…•")
+ require.Contains(t, string(out), "ๅฅฝๅญ—")
// Cursor should be at column 4 (two wide chars = 4 cells)
// ...
}
diff --git a/plugins/omo/skills/programming/references/typescript/README.md b/plugins/omo/skills/programming/references/typescript/README.md
index e71b88fd..33b587f4 100644
--- a/plugins/omo/skills/programming/references/typescript/README.md
+++ b/plugins/omo/skills/programming/references/typescript/README.md
@@ -109,9 +109,9 @@ async function main(): Promise<void> { // no-excuse-ok: catch
| Validation | Zod | Runtime validation + type inference |
| ORM | Drizzle | Type-safe SQL, no codegen |
| HTTP client | `ky` | Thin fetch wrapper (5KB); auto-throw on non-2xx, retry, timeout, hooks, prefixUrl. Browser + Node + Bun + Deno |
-| HTTP client (perf) | `undici` (direct API) | Node backend์—์„œ connection pooling, HTTP/2, pipelining ํ•„์š” ์‹œ |
+| HTTP client (perf) | `undici` (direct API) | Use when a Node backend needs connection pooling, HTTP/2, or pipelining |
-> **HTTP client ๊ทœ์น™** โ€” ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ์—์„œ bare `fetch()`๋Š” ์‚ฌ์šฉ ๊ธˆ์ง€. retryยทtimeoutยท์—๋Ÿฌ ํ•ธ๋“ค๋ง์ด ์ „๋ฌดํ•˜์—ฌ ์žฅ์•  ์‹œ silent failure๋ฅผ ์œ ๋ฐœํ•œ๋‹ค. **`ky`** ๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์„ค์น˜ํ•˜๊ณ , Node backend์—์„œ ๋Œ€๋Ÿ‰ ์š”์ฒญยท์ปค๋„ฅ์…˜ ํ’€ยทHTTP/2 ํŒŒ์ดํ”„๋ผ์ด๋‹์ด ํ•„์š”ํ•˜๋ฉด **`undici`** direct API๋ฅผ ์“ด๋‹ค. ~~`axios`~~ ๋Š” supply-chain compromise(2026-03) ์ดํ›„ ์‚ฌ์šฉ ๊ธˆ์ง€. `node-fetch`๋Š” Node 18+ ๋‚ด์žฅ fetch๋กœ ๋Œ€์ฒด๋˜์–ด ๋ถˆํ•„์š”.
+> **HTTP client rule** โ€” production code must not use bare `fetch()`. It lacks retry, timeout, and error-handling policy, which can cause silent failure during incidents. Install **`ky`** by default, and use the **`undici`** direct API when a Node backend needs high-volume requests, connection pooling, HTTP/2, or pipelining. ~~`axios`~~ is forbidden after the supply-chain compromise (2026-03). `node-fetch` is unnecessary because Node 18+ includes built-in fetch.
| Testing | `bun test` / vitest | Fast, ESM-native |
| Logging | `pino` | Structured JSON, fast |
| CLI | `@clack/prompts` + `commander` | Interactive + parsing |
@@ -127,7 +127,7 @@ bun run ../../scripts/typescript/new-project.ts my-api --path ./projects
Creates: `package.json` (Hono + Zod + Biome), `tsconfig.json` (ultra-strict), `biome.json`, `src/index.ts`, `.gitignore`. Works on macOS, Linux, Windows.
-For manual setup: `bunx tsc --init`, then load `tsconfig-strict.md` for the full strict config.
+For manual setup: `npx tsc --init`, then load `tsconfig-strict.md` for the full strict config.
Key flags beyond `"strict": true`:
diff --git a/plugins/omo/skills/programming/references/typescript/bootstrap.md b/plugins/omo/skills/programming/references/typescript/bootstrap.md
index f0981b79..ecd9dff0 100644
--- a/plugins/omo/skills/programming/references/typescript/bootstrap.md
+++ b/plugins/omo/skills/programming/references/typescript/bootstrap.md
@@ -35,7 +35,7 @@ Use Node when:
- Production target is a Node-specific platform (some serverless platforms don't run Bun yet)
- You're contributing to a Node-only project
-`bunx` replaces `npx`. `bun create` scaffolds projects.
+`npx` runs package binaries without a global install. `bun create` scaffolds projects.
## Package manager โ€” pnpm > npm
diff --git a/plugins/omo/skills/programming/references/typescript/tsconfig-strict.md b/plugins/omo/skills/programming/references/typescript/tsconfig-strict.md
index eb755d25..332b5d85 100644
--- a/plugins/omo/skills/programming/references/typescript/tsconfig-strict.md
+++ b/plugins/omo/skills/programming/references/typescript/tsconfig-strict.md
@@ -138,8 +138,8 @@ For Bun projects, add to `compilerOptions`:
## CI gate
```bash
-bunx biome check .
-bunx tsc --noEmit
+npx biome check .
+npx tsc --noEmit
bun test
```
diff --git a/plugins/omo/skills/programming/scripts/typescript/new-project.ts b/plugins/omo/skills/programming/scripts/typescript/new-project.ts
index 9bb2a3e7..d2f94d18 100644
--- a/plugins/omo/skills/programming/scripts/typescript/new-project.ts
+++ b/plugins/omo/skills/programming/scripts/typescript/new-project.ts
@@ -64,8 +64,8 @@ const pkg = {
scripts: {
dev: "bun --hot src/index.ts",
start: "bun src/index.ts",
- check: "bunx biome check . && bunx tsc --noEmit && bun test",
- "check:fix": "bunx biome check --write .",
+ check: "npx biome check . && npx tsc --noEmit && bun test",
+ "check:fix": "npx biome check --write .",
test: "bun test",
},
dependencies: {
diff --git a/plugins/omo/skills/remove-ai-slops/SKILL.md b/plugins/omo/skills/remove-ai-slops/SKILL.md
index 453b2e59..be45fb08 100644
--- a/plugins/omo/skills/remove-ai-slops/SKILL.md
+++ b/plugins/omo/skills/remove-ai-slops/SKILL.md
@@ -1,6 +1,6 @@
---
name: remove-ai-slops
-description: Remove AI-generated code smells (slop) from branch changes or an explicit file list. Locks behavior with regression tests FIRST, then runs categorized cleanup via parallel `deep` agents in batches of 5, then verifies with quality gates. Covers 10 slop categories including performance equivalences, excessive complexity (object annotations, if/elif variant chains), and oversized modules (250+ pure LOC with mandatory modular refactoring). MUST USE when the user asks to "remove slop", "clean AI code", "deslop", "AI ์ฝ”๋“œ ์ •๋ฆฌ", "AI ์Šฌ๋กญ ์ œ๊ฑฐ", or wants to clean up AI-generated patterns from recent changes. Triggers - "remove ai slops", "clean ai code", "deslop", "cleanup AI generated", "AI ์Šฌ๋กญ ์ œ๊ฑฐ", "AI ์ฝ”๋“œ ์ •๋ฆฌํ•ด์ค˜", "์Šฌ๋กญ ๋นผ๋ผ", "ai-slop ์ •๋ฆฌ".
+description: Remove AI-generated code smells (slop) from branch changes or an explicit file list. Locks behavior with regression tests FIRST, then runs categorized cleanup via parallel `deep` agents in batches of 5, then verifies with quality gates. Covers 10 slop categories including performance equivalences, excessive complexity (object annotations, if/elif variant chains), and oversized modules (250+ pure LOC with mandatory modular refactoring). MUST USE when the user asks to "remove slop", "clean AI code", "deslop", or wants to clean up AI-generated patterns from recent changes. Triggers - "remove ai slops", "clean ai code", "deslop", "cleanup AI generated".
---
## Codex Harness Tool Compatibility
diff --git a/test/lazycodex-ai-bin.test.mjs b/test/lazycodex-ai-bin.test.mjs
index 48a4d44c..a9898283 100644
--- a/test/lazycodex-ai-bin.test.mjs
+++ b/test/lazycodex-ai-bin.test.mjs
@@ -38,7 +38,7 @@ describe("lazycodex-ai npm package", () => {
assert.equal(result.status, 0, result.stderr)
assert.equal(
result.stdout.trim(),
- "bunx --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous",
+ "npx --yes --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous",
)
})
@@ -54,6 +54,6 @@ describe("lazycodex-ai npm package", () => {
// then
assert.equal(result.status, 0, result.stderr)
- assert.equal(result.stdout.trim(), "bunx --package oh-my-openagent omo doctor")
+ assert.equal(result.stdout.trim(), "npx --yes --package oh-my-openagent omo doctor")
})
})
diff --git a/test/no-bunx-text.test.mjs b/test/no-bunx-text.test.mjs
new file mode 100644
index 00000000..651ad906
--- /dev/null
+++ b/test/no-bunx-text.test.mjs
@@ -0,0 +1,50 @@
+import { execFileSync } from "node:child_process"
+import { readFileSync, statSync } from "node:fs"
+import test from "node:test"
+import assert from "node:assert/strict"
+
+const BANNED_RUNNER_TOKEN = ["bu", "nx"].join("")
+const BANNED_STALE_COMMANDS = [
+ ["npx", "lazycodex", "install"].join(" "),
+ ["npx", "omo", "install", "--platform=codex"].join(" "),
+]
+const IGNORED_PREFIXES = [".omo/"]
+
+function trackedFiles() {
+ return execFileSync("git", ["ls-files"], { encoding: "utf8" })
+ .split("\n")
+ .filter((file) => file.length > 0)
+ .filter((file) => !IGNORED_PREFIXES.some((prefix) => file.startsWith(prefix)))
+}
+
+function isBinary(buffer) {
+ return buffer.includes(0)
+}
+
+test("tracked text files use npx instead of the old package runner", () => {
+ const offenders = []
+
+ for (const file of trackedFiles()) {
+ const stat = statSync(file, { throwIfNoEntry: false })
+ if (!stat?.isFile()) continue
+
+ const buffer = readFileSync(file)
+ if (isBinary(buffer)) continue
+
+ const text = buffer.toString("utf8").toLowerCase()
+ if (text.includes(BANNED_RUNNER_TOKEN)) {
+ offenders.push(`${file}: old package runner`)
+ continue
+ }
+
+ for (const command of BANNED_STALE_COMMANDS) {
+ if (text.includes(command)) offenders.push(`${file}: ${command}`)
+ }
+ }
+
+ assert.deepEqual(
+ offenders,
+ [],
+ `tracked text files with old package runner: ${offenders.join(", ")}`,
+ )
+})
diff --git a/test/no-korean-text.test.mjs b/test/no-korean-text.test.mjs
new file mode 100644
index 00000000..c9e2527f
--- /dev/null
+++ b/test/no-korean-text.test.mjs
@@ -0,0 +1,37 @@
+import { execFileSync } from "node:child_process"
+import { readFileSync, statSync } from "node:fs"
+import test from "node:test"
+import assert from "node:assert/strict"
+
+const HANGUL_PATTERN = /[\u1100-\u11ff\u3130-\u318f\uac00-\ud7af]/u
+const IGNORED_PREFIXES = [".omo/"]
+
+function trackedFiles() {
+ return execFileSync("git", ["ls-files"], { encoding: "utf8" })
+ .split("\n")
+ .filter((file) => file.length > 0)
+ .filter((file) => !IGNORED_PREFIXES.some((prefix) => file.startsWith(prefix)))
+}
+
+function isBinary(buffer) {
+ return buffer.includes(0)
+}
+
+test("tracked text files do not contain Hangul", () => {
+ const offenders = []
+
+ for (const file of trackedFiles()) {
+ const stat = statSync(file, { throwIfNoEntry: false })
+ if (!stat?.isFile()) continue
+
+ const buffer = readFileSync(file)
+ if (isBinary(buffer)) continue
+
+ const text = buffer.toString("utf8")
+ if (!HANGUL_PATTERN.test(text)) continue
+
+ offenders.push(file)
+ }
+
+ assert.deepEqual(offenders, [], `tracked text files with Hangul: ${offenders.join(", ")}`)
+})
diff --git a/test/no-launch-gating-text.test.mjs b/test/no-launch-gating-text.test.mjs
new file mode 100644
index 00000000..50d1f02b
--- /dev/null
+++ b/test/no-launch-gating-text.test.mjs
@@ -0,0 +1,46 @@
+import { execFileSync } from "node:child_process"
+import { readFileSync, statSync } from "node:fs"
+import test from "node:test"
+import assert from "node:assert/strict"
+
+const SEARCH_ROOTS = ["README.md", "packages/web/"]
+const IGNORED_PREFIXES = [".omo/"]
+const BANNED_WORD_GROUPS = [
+ ["coming", "soon"],
+ ["coming", "june"],
+ ["currently", "available", "for", "opencode"],
+ ["codex", "edition", "is", "coming"],
+ ["waitlist"],
+]
+
+function trackedFiles() {
+ return execFileSync("git", ["ls-files"], { encoding: "utf8" })
+ .split("\n")
+ .filter((file) => file.length > 0)
+ .filter((file) => SEARCH_ROOTS.some((root) => file === root || file.startsWith(root)))
+ .filter((file) => !IGNORED_PREFIXES.some((prefix) => file.startsWith(prefix)))
+}
+
+function isBinary(buffer) {
+ return buffer.includes(0)
+}
+
+test("public LazyCodex surfaces do not contain launch gating copy", () => {
+ const offenders = []
+
+ for (const file of trackedFiles()) {
+ const stat = statSync(file, { throwIfNoEntry: false })
+ if (!stat?.isFile()) continue
+
+ const buffer = readFileSync(file)
+ if (isBinary(buffer)) continue
+
+ const text = buffer.toString("utf8").toLowerCase()
+ for (const group of BANNED_WORD_GROUPS) {
+ const phrase = group.join(" ")
+ if (text.includes(phrase)) offenders.push(`${file}: ${phrase}`)
+ }
+ }
+
+ assert.deepEqual(offenders, [], `launch gating copy remains: ${offenders.join(", ")}`)
+})