OpenWiki｜AIエージェント向けにコードドキュメントを自動生成・維持するCLI

ポイント

• エージェント専用設計：AIエージェントが開発時に参照しやすい形式のドキュメントを生成。
• ドキュメントの自動更新：GitHub Actionを使い、1日1回コードの変更を検知して自動でPRを作成。
• 主要プロバイダーに対応：OpenAIやAnthropic、OpenRouterなどのLLMを利用可能。

概要・解決する課題

AIエージェントによる自動開発が普及する一方、エージェントがコードベースの全体像やコンテキストを正確に理解できず、的外れなコードを生成する課題がありました。従来は、人間が手動でエージェント用の仕様書や指示ファイルを更新し続ける必要がありました。

OpenWikiは、この課題を解決するCLIツールです。コードベースからエージェント向けのドキュメントを自動生成し、さらに開発エージェントに対して AGENTS.md や CLAUDE.md を経由してドキュメントを参照するよう自動で指示文（プロンプト）を付与します。

ただし、ドキュメントの生成や更新には外部のLLM APIを利用するため、完全なオフライン環境での利用やAPI利用料をゼロにすることはできません。生成するのはLLMによる自然言語の説明であり、CodeGraphのようにコードを構文解析して呼び出し関係を索引化するアプローチとは役割が異なります。

内部的にはlsやgrep、read_fileなどのツールを自律的に呼び出すエージェント型の実装のため、API利用料は固定額ではなく探索範囲に応じて変動します。日次更新はgit diffで変更箇所に絞る設計になっており、リポジトリ全体を読み直す初回生成より軽く済む想定です。

なぜ注目されているか

AIエージェントが実務のコードを編集する機会が増えるなか、コンテキスト不足によるエラーを減らすために「エージェントに最適化されたドキュメント」の需要が高まっています。LangChain公式チームによる開発という信頼性も、導入検討の大きな動機となっています。

主なユースケース

• エージェント向け案内ファイルの自動整備： プロジェクト内に CLAUDE.md や AGENTS.md を配置し、エージェントがタスク開始時に最優先で読み込む指示文とプロジェクト概要を自動で作成・追加します。
• CI/CDによるドキュメントの陳腐化防止： GitHub Actionsのワークフロー（openwiki-update.yml）を設定し、1日1回自動でコード変更を反映したドキュメント更新PRをオープンします。

動作環境

• ランタイム: Node.js環境（npmによるグローバルインストール）
• 前提条件: サポートされているLLMプロバイダー（OpenAI, Anthropic, OpenRouter, Fireworks, Baseten等）のAPIキー

npm install -g openwiki

openwiki --init

こんな人におすすめ

• AIエージェントを自社コードベースに本格導入したい開発チーム
• コード変更に伴うドキュメントの更新漏れを防ぎたい開発者
• エージェントがコンテキストを読み違えて発生する無駄なトークン消費を抑えたい方