@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 CONTEXT.md / .omo/rules/** and other explicit rule sources into context via SessionStart, UserPromptSubmit, PostToolUse, PostCompact; AGENTS.md is left to Codex native handling.
• 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 plugin bundle includes Context7 as a default MCP in its .mcp.json, using the hosted https://mcp.context7.com/mcp endpoint. The installer leaves any existing user-level [mcp_servers.context7] block untouched but no longer creates one.

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.

The captured properties are limited to product/runtime metadata, operating-system metadata, coarse machine shape (cpu_count, cpu_model, total_memory_gb), locale/timezone, shell/terminal hints, source, reason, and day_utc. Telemetry does not send prompt contents, chat transcripts, source files, repository contents, file paths, access tokens, API keys, raw hostnames, Git remotes, usernames, email addresses, or runtime error diagnostics.

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 Codex Light telemetry and the Privacy Policy 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