LazyCodexとは？Codex向けエージェントハーネスでプロジェクトメモリ・計画・実行を自動化する方法

OpenAI Codexは強力なAIコーディングエージェントですが、「複雑なコードベースを跨いだ大規模リファクタリング」「複数ステップの計画的な機能実装」では、文脈が途切れてしまうことが課題でした。

LazyCodexはその課題を解決するCodex専用のエージェントハーネスです。GitHub スター数 999 のこのツールを使えば、プロジェクトメモリの自動管理・戦略的タスク計画・自己参照実行ループ・Oracle検証が統合されたフル装備の開発エージェントをCodex上で実現できます。

LazyCodexの主要機能

LazyCodexはSisyphus LabsのOmOエージェントフレームワークをCodexに移植したもので、以下の機能を提供します。

プロジェクトメモリ管理

コードベースの構造・依存関係・過去の決定事項を記憶し、セッションをまたいで文脈を維持します。大規模プロジェクトでも「前回どこまでやったか」を把握し続けます。

戦略的計画（Prometheusプランナー）

$ulw-plan "実装内容" コマンドで、タスクをMarkdownの実装計画書（plans/<slug>.md）として出力します。コードは書かず、設計だけに集中した専用プランナーです。

自己参照実行ループ

$ulw-loop "タスク" は自己参照ループで、Oracle検証で完了が確認されるまで最大500イテレーション実行します。途中でエラーが発生しても自動リカバリします。

自動実行・完了確認

$start-work plan-name

このコマンドだけで計画のすべてのチェックボックスが完了するまで自動実行し、ORCHESTRATION COMPLETE を表示して終了します。

OpenAI Codex エージェントハーネス使い方・インストール手順

インストールは1コマンドで完了します。

npx lazycodex-ai install

完全自律モードでのインストール

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

インストール確認

npx lazycodex-ai doctor

doctor コマンドでプラグインキャッシュ・フック・MCPサーバー・エージェント・設定の健全性を確認できます。

Codexマーケットプレース経由でのインストール（実験的）

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

インストール後、Codex起動時にhookの承認を行います。初回は LazyCodex bootstrap running in background と表示されますので、完了後にセッションを再起動してください。

AIエージェントプロジェクトメモリ自動化 TypeScript — 活用例

活用例1: 大規模レガシーコードのリファクタリング

バックエンドエンジニアが数万行のTypeScriptコードベースをモジュール化する場合、LazyCodexの$ulw-planで依存関係の分析と移行順序の計画を立案し、$ulw-loopでリファクタリングを段階的に自動実行します。手動で数週間かかる作業を大幅に短縮できます。

活用例2: MVP開発の加速

スタートアップのソロ開発者がCodexとLazyCodexを組み合わせてMVP開発を自動化します。バックエンドAPI実装・テスト生成・型定義の追加まで、$start-workコマンド一発で完結させることができます。

活用例3: CI/CDパイプラインへの統合

Codexのautonomousモードと組み合わせて、CI環境でLazyCodexを実行するパイプラインを構築します。PRのレビューコメントを自動的に反映する「自律的なコード修正ループ」が実現できます。

この技術を学ぶ

AIエージェント開発に興味を持った方には、Udemyのオンラインコースもおすすめです。

🎓 関連するAIエージェントコース一覧 — セール時（最大90%OFF）を狙うとお得です

まとめ

LazyCodexはCodexを「考えて計画して実行するフルスタックエージェント」に変える強力なハーネスです。GitHub スター数 999 の実績を持ち、npx lazycodex-ai install の1コマンドで始められます。

大規模プロジェクトの開発効率化、複雑なリファクタリングの自動化、チーム開発での標準エージェント基盤として、ぜひ活用してみてください。