LazyCodex — Codex 向け OmO エージェントハーネス

プロジェクトの位置づけ

OmO コアエンジン

Codex 対象プラットフォーム

$ スキル・コマンド接頭辞

0 グローバル install 不要

LazyCodex は複雑なコードベース向けのエージェントハーネスを、Codex 上でそのまま使える形にまとめた配布レイヤ。プロジェクトメモリ、計画、実行、検証完了までをスキル・フック・マルチエージェントで扱う。LazyVim が lazy.nvim をまとめたのと同様に、OmO の品質バーを Codex ユーザー向けに一括導入する。

公開サイトは lazycodex.ai。詳細ドキュメントも同ドメイン配下。

推奨: npx インストーラ

グローバル install は不要。npx で常に最新の OmO インストーラを呼ぶ。

npx lazycodex-ai install

内部では npx --yes --package oh-my-openagent omo install --platform=codex に相当する。TUI なし・自律モード:

npx lazycodex-ai install --no-tui --codex-autonomous

bin/lazycodex-ai.js は install 以外のサブコマンドも oh-my-openagent の omo CLI へ透過的に転送する。

インストール確認と削除

コマンド	役割
`npx lazycodex-ai doctor`	プラグインキャッシュ、フック、MCP、エージェント、設定の健全性レポート
`npx lazycodex-ai uninstall`	プラグインキャッシュ・bin リンク・エージェントロール・`~/.codex/config.toml` の管理セクションを削除

実験的: Codex マーケットプレイス

主経路は npx のまま。Codex 内 /plugins または CLI からマーケットプレイス sisyphuslabs 経由でも omo を追加できる。

codex plugin marketplace add https://github.com/code-yeongyu/lazycodex
codex plugin add omo@sisyphuslabs

フック承認: マーケットプレイス経路では起動時レビューで omo フックを承認するまでフックは動かない。初回承認後はバックグラウンドで bootstrap が走り、完了後にセッション再起動が必要。自律モードは明示的に --codex-autonomous を選ぶ。

Codex コンポーザで呼ぶ $ コマンド

入力	概要
`$ulw-loop "task" [--completion-promise=TEXT] [--strategy=reset\|continue]`	Oracle 検証付きの自己参照ループ。ultrawork モードは最大 500 反復、通常は 100 反復で打ち切り。
`$ulw-plan "what to build"`	Prometheus 戦略プランナー。`plans/<slug>.md` に計画を書き、プロダクトコードは変更しない。
`$start-work [plan-name] [--worktree <path>]`	計画のチェックリストを Boulder 進捗で実行し、全項目完了で ORCHESTRATION COMPLETE を出力。

Composer で $ を入力するとインストール済みスキル一覧（init-deep、ulw-loop など）が開く。セッション中のフックは LazyCodex(<version>): ... 形式でステータスを表示する。

典型的な作業の流れ

$init-deep → $ulw-plan → $start-work → $ulw-loop / review-work

プロジェクトメモリ: $init-deep が階層的 AGENTS.md を生成。複雑なディレクトリをスコアリングし、コード近傍にガイダンスを置く。
計画: 実装前に判断が要るとき $ulw-plan。出力は plans/ 配下の Markdown のみ。
実行: 計画が固まったら $start-work。チェックリストを durable な進捗で消化する。
検証完了: 証拠ベースで終わらせるとき $ulw-loop。実装後の多角的レビューは review-work スキル。

使い分け: 計画だけ → $ulw-plan。計画済みの一括実行 → $start-work。終了条件が曖昧な反復作業 → $ulw-loop。

インストールされる主なスキル

スキル	用途
`$init-deep`	階層的 `AGENTS.md` によるプロジェクトメモリ
`review-work`	実装後の多角的レビュー
`remove-ai-slops`	挙動を変えず AI 臭のあるコードを整理
`frontend-ui-ux`	UI 面の仕上げ
`programming`	TypeScript / Rust / Python / Go の厳格な実装規律
`LSP`	診断・定義・参照・シンボル・リネーム
`AST-grep`	構造的検索・書き換え（MCP ではなくスキルとして同梱）
`rules`	AGENTS / rules / instruction ファイルからのプロジェクト指示
`comment-checker`	編集系操作後のフィードバック

サブエージェントロール

~/.codex/agents/ にロールが展開される。Codex の spawn_agent で agent_type を指定して子エージェントを起動する。

spawn_agent({
  "message": "TASK: map the auth flow end to end.",
  "agent_type": "explorer"
})

利用可能なロール例: explorer librarian plan momus metis codex-ultrawork-reviewer

agent_type パラメータが無い Codex ビルドでは、message 内でロールを記述するフォールバックにスキル側が対応する。

omo プラグイン構成（抜粋）

ローカル Codex プラグイン名は omo。内部コンポーネントは components/ 配下で分離されている。

ulw-loop / ultrawork — ループと ultrawork モード
lsp / lsp-daemon / lsp-tools-mcp — LSP 連携
rules / comment-checker — 指示と編集後チェック
bootstrap — 初回セットアップ（config、エージェントロール、sg バイナリなど）
telemetry — 匿名 DAU イベント（オプトアウト可能）

テレメトリはプロンプト・ソースファイル・パスを送らない。無効化例:

export OMO_CODEX_DISABLE_POSTHOG=1
export OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0

リポジトリ構成

LazyCodex 本体は薄い配布レイヤ。コアは src/ サブモジュールの oh-my-openagent。

flowchart TB
  subgraph dist["lazycodex（配布）"]
    BIN["bin/lazycodex-ai.js\nnpx エントリ"]
    PKG["package.json\nlazycodex-ai"]
    WEB["packages/web\nNext.js 15 + Tailwind v4"]
    PLG["plugins/omo\nCodex プラグイン omo"]
  end
  subgraph core["コアエンジン"]
    OMO["src/ → oh-my-openagent"]
  end
  BIN -->|"spawnSync npx omo"| OMO
  PKG --> BIN
  PLG -->|"install 時に展開"| OMO
  WEB -->|"lazycodex.ai"| CF["Cloudflare Workers"]

lazycodex/
├── src/                     → oh-my-openagent（submodule）
├── packages/
│   └── web/                 → Next.js 15 + Tailwind v4（lazycodex.ai）
├── plugins/omo/             → Codex 向け omo プラグイン
├── bin/lazycodex-ai.js      → npx エントリ
└── package.json

omo.dev プロジェクトの一部として、OmO を Codex 向けにパッケージした製品線。

タスク別モデル選択

OmO は全サブタスクに最上位モデルを使い続けない。タスクカテゴリとフォールバックチェーンでモデルを切り替え、クォータを抑えつつ品質を保つ。

カテゴリ	向き	例（README 記載）
`quick`	小さな編集・軽量作業	`gpt-5.4-mini`
`ultrabrain`	難しい論理・深い推論	高推論 GPT（`xhigh` 等）
agentic coding	ツール連鎖・実装	`gpt-5.3-codex` など Codex 向けモデル

定義の参照元は OmO 側の openai-categories.ts と model-requirements.ts。セッション中に複数の GPT 系モデル名が出ても、ベンチマーク駆動の意図的ルーティングである。

公式・関連

GitHub: code-yeongyu/lazycodex — 本リポジトリ（npm: lazycodex-ai）
lazycodex.ai — 製品サイト・ドキュメント
oh-my-openagent — コアエンジン（OmO）
omo.dev — プロジェクトハブ
Sisyphus Labs — 保守・Jobdori（OmO ビルド担当）