zosmaai/pi-llm-wiki

📚 pi‑llm‑wiki – 自己維持型、Obsidian互換のLLM駆動Wiki

What it is

• オープンソースの拡張機能(npmパッケージ@zosmaai/pi-llm-wiki)で、プレーンなMarkdownファイルで構成される持続可能な相互リンク付きナレッジベースを構築できます。これはpiコーディングエージェントエコシステム(および互換性のあるoh‑my‑piホスト)向けに設計されていますが、汎用のMCP(Model‑Client‑Protocol)サーバーも同梱されており、Claude‑Code、Cursor、Windsurf、Zedなどのクライアントからも利用できます。
• Andrej Karpathy氏のLLM Wikiパターンに従い、生のソースをキャプチャし、LLMがそれらを摂取して、生成された要約が永続的なWikiページとなり、モデルが後でクエリできるようになります。

Why it matters

• ほとんどのRAGセットアップは、ドキュメントを一度きりのルックアップとして扱います。pi‑llm‑wikiは、ソースを不変のパケットに変換し、構造化されたソースページを生成し、その後、標準的な概念/エンティティ/統合/分析ページを作成する中間レイヤーを追加します。したがって、Wikiは複利的に成長し、新しいソースと回答された各質問が、成長し続ける検索可能なナレッジグラフの一部になります。
• すべてのページは、安定したフロントマターと引用IDを持つ可搬性のあるObsidianフレンドリーなMarkdownスキーマであるOpen Knowledge Format (OKF) v0.2で保存されます。保管庫を移動したり、バージョン管理したり、出典を失うことなくエクスポートしたりできます。

Key concepts & architecture

レイヤー	場所	役割
パーソナル	~/.llm-wiki/	常時アクティブで、プロジェクト間で個人の知識を保持します。
プロジェクト	<project>/.llm-wiki/	オプションのプロジェクト単位のWikiで、パーソナルレイヤーから読み取ることもできます。
カンパニー (将来)	Git管理リポジトリ	共有チームWiki。ページはwiki_publishで昇格されます。

この拡張機能は、現在のディレクトリから上位に向かって.llm-wiki/フォルダーを探してアクティブな保管庫を解決し、見つからない場合はパーソナル保管庫にフォールバックします。

Main capabilities

• キャプチャ (wiki_capture_source) – URL、PDF、Markdown、JSON、XML、または貼り付けられたテキストを不変のソースパケット(raw/sources/SRC‑…)に変換します。
• インジェスト (wiki_ingest) – キャプチャされたパケットを、ソース要約、概念、エンティティ、統合、分析の4層のWikiページにバッチ処理します。
• リコール / クエリ (wiki_recall, /wiki-query) – パーソナルとプロジェクトの両方の保管庫を検索し、適切な引用付きのモデル生成回答を取得し、オプションで回答を分析ページとしてファイルします。
• 検索とインデックス (wiki_search, wiki_reindex) – 語彙的なQMDインデックス(モデル不要)に加えて、オプションのセマンティック埋め込み。
• Lintとガードレール (wiki_lint) – 孤立ページ、壊れたリンク、重複したエイリアス、カバレッジギャップなどの決定的な健全性チェック。
• ダッシュボード (wiki_status, /wiki-dashboard) – ページ数、新しさ、最近のアクティビティ、インジェストキューのクイックビュー。
• 自動ブートストラップ – フォルダーで拡張機能を最初に実行すると、新しいWikiを作成することを提案します(/wiki-init)。
• エージェントのワーキングメモリ(オプトイン) – 完了したタスクのツール呼び出しトレースをキャプチャし(wiki_capture_trajectory)、後で再利用可能なスキルページに蒸留します(wiki_distill_skills, /wiki-skills)。
• MCPサーバー – すべてのツールを公開するスタンドアロンのstdioサーバー(dist/mcp/index.js)。piホストなしで任意のMCP互換クライアントがWikiを使用できます。

Installation & first use

# piホストの場合
pi install npm:@zosmaai/pi-llm-wiki
# oh‑my‑piの場合
omp install @zosmaai/pi-llm-wiki
# または他のMCPクライアント用の通常のnpm開発依存関係として
npm install --save-dev @zosmaai/pi-llm-wiki

次に、ターミナル(またはpi/ompのスラッシュコマンド)で:

/wiki-init "AI research"
/wiki-capture_source https://example.com/article
/wiki_ingest   # または /wiki-ingest
/wiki-query "What are the trade‑offs between long‑context models and RAG?"

READMEのデモGIFは、pi内のUIフローを示しています。

Configuration

• WIKI_ROOT (保管庫の場所を上書き)やWIKI_MARKITDOWN_TIMEOUT_MS (PDF→Markdown抽出タイムアウト)などの環境変数が尊重されます。
• 設定はホストの構成ファイル(.pi/settings.json, .omp/settings.jsonなど)から読み取られ、/wiki-settingsスラッシュコマンドで編集できます。

Project health

• CIバッジ、npmバージョン、ダウンロード統計、85%のテストカバレッジ、CodeQL、BiomeリンティングがすべてREADMEに表示されており、積極的に保守されているTypeScriptコードベースであることを示しています。
• ドキュメントはhttps://zosmaai.github.io/pi-llm-wiki/でホストされています。

Who might use it

• 自分のLLM支援作業と同期を保つパーソナルナレッジベースを望む研究者やエンジニア。
• 同じOKF形式に基づく会社全体のWikiを共有する予定のチーム。
• piやoh‑my‑piエージェント、または任意のMCP互換IDEを使用しており、専有のRAGストアに代わるファイルベースでバージョン管理された代替手段を望む人。

---

TL;DR: pi-llm-wikiは、生のドキュメントをポータブルでObsidian互換のMarkdown Wikiに変換するTypeScript npmパッケージであり、LLMによって自動的に維持されます。pi/oh‑my‑piエージェントおよび任意のMCPクライアントで動作し、キャプチャ、インジェスト、検索可能なリコール、健全性チェック、オプションのエージェントトレースメモリを提供します—すべてオープンでバージョン管理された形式の下で。