@oh-my-opencode/omo-codex

Codex harness adapter for oh-my-openagent. Brings the OMO experience (rules injection, comment checker, LSP MCP, ultrawork, ulw-loop, start-work continuation, telemetry) into OpenAI Codex CLI through Codex's native plugin system.

Layout

Components Vendored

• rules (TypeScript) - injects AGENTS.md / CLAUDE.md / .omo/rules/** into context via SessionStart, UserPromptSubmit, PostToolUse, PostCompact.
• comment-checker (TypeScript) - runs @code-yeongyu/comment-checker after apply_patch / edit / write tool use.
• lsp (TypeScript + LSP MCP) - exposes LSP diagnostics, navigation, symbols, rename via MCP + post-edit hooks.
• git-bash (TypeScript + Git Bash MCP) - exposes the Windows-only git_bash MCP and reminds Codex on the first shell-like call, including the first one after compaction.
• ultrawork (TypeScript) - keyword detector (ulw / ultrawork) that injects the full ultrawork directive; bundled agent TOML files are installed into CODEX_HOME/agents.
• ulw-loop (TypeScript) - durable multi-goal orchestration backed by .omo/ulw-loop/ evidence audit.
• start-work-continuation (TypeScript) - Stop / SubagentStop continuation hook for .omo/boulder.json start-work plans.
• telemetry (TypeScript) - anonymous daily active telemetry hook.

Install

End users invoke through the omodex CLI. This package is the Light edition of omo — install it directly with:

npx lazycodex-ai install
# non-interactive recommended mode:
npx lazycodex-ai install --no-tui --codex-autonomous

To install both the Ultimate edition (OpenCode plugin) and the Light edition (this package) at once, use --platform=both.

The installer copies the built plugin into ~/.codex/plugins/cache/sisyphuslabs/omo/<version>/, writes stable agent TOML links through ~/.codex/.tmp/marketplaces/sisyphuslabs/plugins/omo/, enables omo@sisyphuslabs in ~/.codex/config.toml, and registers the sisyphuslabs marketplace from the local built cache. lazycodex-ai is the npm/bin alias and lazycodex is the marketplace repository; the marketplace identity remains sisyphuslabs.

To remove managed Codex Light state, run npx lazycodex-ai cleanup. The command removes managed sisyphuslabs cache/marketplace directories, strips OMO marketplace/plugin/hook-state config blocks with a backup, removes installed agent TOML links from the manifest, and repairs the known project-local legacy .codex/config.toml conflict while leaving .codex / .omx project files in place.

The Codex install also registers a Context7 documentation MCP in ~/.codex/config.toml with a placeholder API key (YOUR_API_KEY). Replace it with your own Context7 API key to enable the docs MCP, or delete the [mcp_servers.context7] block if you do not want it.

Native Windows installs prepare Git Bash before the installer mutates ~/.codex/. If bash.exe is not already discoverable, the installer first tries the same best-effort install command shown here, then resolves Git Bash again:

winget install --id Git.Git -e --source winget
where bash

For a custom Git Bash location:

setx OMO_CODEX_GIT_BASH_PATH "C:\Program Files\Git\bin\bash.exe"

$env:OMO_CODEX_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

Set OMO_CODEX_SKIP_GIT_BASH_AUTO_INSTALL=1 to skip the best-effort winget install --id Git.Git -e --source winget attempt and keep the explicit install guidance path.

The installer does not write a global Codex shell config. On Windows it enables the plugin MCP policy for git_bash; on non-Windows it keeps the manifest bundled but writes enabled = false for that MCP server. The Git Bash hook injects fixed guidance before the first Codex shell-like Bash hook call in a session, and again before the first shell-like call after PostCompact, recommending git_bash before built-in exec_command.

To install both editions in one command, use --platform=both.

Telemetry

Anonymous telemetry uses the same PostHog project as oh-my-openagent but emits the distinct event omo_codex_daily_active. The event is sent at most once per UTC day per machine from two sources:

Both sources share the same SHA256-hashed installation identifier (sha256("omo-codex:" + hostname)), suppress PostHog person profiles, and write the daily dedup state to ~/.local/share/omo-codex/posthog-activity.json.

Opt out with:

# Codex-only
export OMO_CODEX_DISABLE_POSTHOG=1
export OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0

# Globally (also disables oh-my-openagent telemetry)
export OMO_DISABLE_POSTHOG=1
export OMO_SEND_ANONYMOUS_TELEMETRY=0

The identity constants and opt-out behavior are pinned across both sources by src/telemetry/cross-package-equivalence.test.ts.

See /Users/yeongyu/local-workspaces/omodex/docs/legal/privacy-policy.md for the full disclosure.

Component Sources

The bundled component implementations come from the Sisyphus Labs Codex plugin family:

• code-yeongyu/codex-rules
• code-yeongyu/codex-comment-checker
• code-yeongyu/codex-lsp
• code-yeongyu/codex-ultrawork
• code-yeongyu/codex-ulw-loop
• code-yeongyu/codex-start-work-continuation