open-zk-kb

open-zk-kb

新しいセッションを開始しても、エージェントはあなたが何者かまったく分かっていません。また同じです。使用している技術スタックや規約、これまでに5回も訂正したあのエッジケースを、もう一度説明し直します。

open-zk-kb はエージェントにメモリーを与えます。訂正が定着し、コンテキストが蓄積され、セッションを重ねるごとに前回より賢い状態で始められます。

_{Pi で一連の操作を確認できます。設定を保存して新しいセッションに引き継ぎ、保管庫の内容を確認し、役に立たなくなったら削除します。}

クイックスタート

Bun が必要です — curl -fsSL https://bun.sh/install | bash でインストールしてください

bunx open-zk-kb@latest

インストーラーは選択したクライアントを設定し、エージェント向けの指示をインストールして、ローカルの保管庫を作成します。対応クライアント：OpenCode、Claude Code、Cursor、Windsurf、Zed、Pi、OMP。

手動インストールとトラブルシューティングについては、セットアップガイドをご覧ください。

open-zk-kb を選ぶ理由

エージェントはセッションのたびにゼロから始まります。記憶もなく、学習もありません。同じ間違いを訂正し、同じ規約を説明し、同じコンテキストを教え直すことになります。ツールを切り替えると、さらに悪化します。Cursor のエージェントは Claude のエージェントが学んだことを知りません。

open-zk-kb がこの問題を解決します。

• 一度訂正すれば、定着します — エージェントが訂正、設定、決定事項を保存します。次のセッションでは、すでに把握しています。
• あらゆるツールで使えます — Claude Code、Cursor、Windsurf、OpenCode、Zed、Pi、OMPで1つのナレッジベースを共有します。
• 関連情報を見つけます — ハイブリッド検索ではキーワードだけでなく意味も照合するため、有用なコンテキストだけが表示されます。
• ローカルで動作します — API キーもクラウドも不要で、オフラインでも使えます。データはお使いのマシンに保存されます。
• 人が読み取れます — 閲覧、編集、バージョン管理ができるプレーンな Markdown ファイルです。
• オープンソース — MIT ライセンスです。

Pi：ネイティブのナレッジツール

Pi パッケージをインストールしてから、Pi を再起動してください。

pi install npm:open-zk-kb

この拡張機能では、10個すべての knowledge-* ツールを Pi で直接使えます。結果は Pi ネイティブのコンパクトな形式で表示されます。検索、保存、コンテキスト、ヘルスチェックには要点を絞った概要と展開可能な詳細が表示され、その他のツールには簡潔なステータスが表示されます。MCP サーバーとローカルの SQLite／埋め込み処理には引き続き Bun >= 1.0 が必要です。Pi 自体はサポート対象の Node.js ランタイムで動作します。そのため、Pi パッケージを使用する場合も Bun のインストールが必要です。

Pi はセッション開始時にアクティブなプロジェクト設定も自動で読み込み、モデルが検索を開始する必要なくモデルのコンテキストに挿入します。表示される knowledge-context エントリーは、ツール呼び出しを捏造することなく、実行内容を報告します。

設定のワークフロー全体とレンダラーの例については、Pi エクスペリエンスガイドをご覧ください。インストーラーが管理する手順、検証、トラブルシューティングについては、Pi のインストールをご覧ください。

設定

設定は不要です。ローカル埋め込みは API キーなしで、すぐに利用できます。

埋め込み、保管庫のパス、ライフサイクルの調整、サーバー設定については、設定ガイドをご覧ください。

内部の仕組み

Zettelkasten メソッドに基づいています。原子的で、相互にリンクされたノートを、構造化された種類とともに作成します。各ノートには、決定事項、好み、注意点など、1 つの概念を記録し、関連するノートにリンクすることで、相互につながったナレッジグラフを構築します。

検索では、SQLite FTS5 による全文インデックスと、ローカルのベクトル埋め込み（MiniLM-L6-v2）を組み合わせ、意味的に一致する項目を探します。Markdown ファイルが信頼できる唯一の情報源であり、データベースは再構築可能なインデックスです。

テレメトリー

有効にした場合（telemetry.enabled: true および telemetry.share: true）、open-zk-kb は完了したセッションごとに匿名イベントを 1 件、次回起動時に PostHog（EU Cloud）へ送信します。イベントには、標準化されたクライアント名、範囲を制限したモデル ID、Vault のサイズ、10 個すべてのツールの使用回数が含まれます。ノートの内容、クエリ、パス、名前、メールアドレスは含まれません。実行時の既定値は無効です。対話型インストーラーでは、明示的な同意を得た後にのみ共有を有効にします。一方、無人インストールおよびパッケージの直接インストールでは、個別に設定しない限り無効のままです。共有を常にブロックするには DO_NOT_TRACK=1 を設定してください（ローカルの SQLite カウンターには影響しません）。または、両方のフラグを false のままにしてください。イベントスキーマと詳細については、テレメトリーを参照してください。

ドキュメント

• セットアップガイド — インストール、クライアント別の設定、トラブルシューティング
• Pi の利用体験 — ネイティブツール、自動設定される好み、レンダラーのギャラリー
• ツールリファレンス — 10 個すべての MCP ツールのパラメーターと使用例
• ノートのライフサイクル — ノートの種類、ステータス、レビューステム
• 設定 — 埋め込み、Vault、ライフサイクル、サーバーの設定
• アーキテクチャ — 二重ストレージ、所有権モデル、設計上の決定
• 開発 — ローカル開発、テスト、デバッグ
• コントリビューション — コントリビューター向けガイドライン

ライセンス

MIT ライセンス