open-zk-kb

新しいセッションを開くと、エージェントはあなたが誰かまったく知りません。またです。スタック、規約、5回も修正したあのエッジケースを、また説明し直すことになります。

open-zk-kb はエージェントに記憶を与えます — 修正は定着し、コンテキストは積み重なり、毎回のセッションが前回より賢く始まります。

クイックスタート

** Bun が必要です** — curl -fsSL https://bun.sh/install | bash でインストール

bunx open-zk-kb@latest

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

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

Related MCP server: Memento

open-zk-kb の理由

エージェントは毎回ゼロから始まります。記憶も学習曲線もありません。同じ間違いを修正し、同じ規約を説明し直し、同じコンテキストを再教育します。ツールを切り替えるとさらに悪化します — Cursor エージェントは Claude エージェントが学んだことを知りません。

open-zk-kb はそれを解決します。

• 一度修正すれば定着 — エージェントは修正、プリファレンス、決定を保存します。次のセッションでは、すでに知っています。

• すべてのツールで動作 — Claude Code、Cursor、Windsurf、OpenCode、Zed、Pi、OMP で共有される単一のナレッジベース

• 関連するものを見つける — ハイブリッド検索はキーワードだけでなく意味をマッチングし、有用なコンテキストだけが表面化します

• ローカルで実行 — 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 クラウド）に送信します。これには、正規クライアント、制限付きモデル ID、ボールトサイズ、10 個すべてのツールのカウントが含まれます — ノートの内容、クエリ、パス、名前、メールアドレスは含まれません。ランタイムのデフォルトは無効です。インタラクティブインストーラーは、肯定的な同意があった場合にのみ共有を有効にします。無人インストールと直接パッケージインストールは、別途設定しない限り無効のままです。DO_NOT_TRACK=1 を設定すると、共有を無条件にブロックします（ローカル SQLite カウンターは影響を受けません）。または両方のフラグを false のままにします。完全なイベントスキーマと詳細については、テレメトリ を参照してください。

ドキュメント

• セットアップガイド — インストール、クライアント別設定、トラブルシューティング

• Pi エクスペリエンス — ネイティブツール、自動プリファレンス、レンダラーギャラリー

• ツールリファレンス — パラメータと例を含む全 10 個の MCP ツール

• ノートライフサイクル — ノートの種類、ステータス、レビューシステム

• 設定 — 埋め込み、ボールト、ライフサイクル、サーバー設定

• アーキテクチャ — デュアルストレージ、所有権モデル、設計上の決定

• 開発 — ローカル開発、テスト、デバッグ

• コントリビューション — コントリビューター向けガイドライン

ライセンス

MIT ライセンス