ctxvault は何をしますか?
AIエージェントのためのローカルメモリ基盤。隔離された保管庫にナレッジやスキルを保存し、構成・制御・クエリできます。
概要
ctxvault は、AIエージェントがローカルファイルシステム上で構造化されたメモリを管理できるようにするツールです。各「保管庫」は独立したディレクトリまたはファイルとして存在し、特定のコンテキストや知識ドメインを保持します。この分離により、エージェントは異なるプロジェクトやタスク間でデータを混同することなく、安全に操作できます。
主な機能
- 隔離された保管庫: 各保管庫は独立しており、他の保管庫のデータにアクセスできません。
- 柔軟な構成: 保管庫はJSONまたはマークダウン形式で定義できます。
- クエリ機能: エージェントは保管庫に対して検索や取得のクエリを実行できます。
- プラットフォーム非依存: Claude Code、Cursor、Codexなど、ファイルシステムAPIを持つあらゆるAIエージェントで動作します。
使用方法
保管庫の作成
保管庫は、以下のようなディレクトリ構造で作成します:
.vaults/
├── project-knowledge/
│ ├── index.json
│ └── docs.md
└── personal-notes/
└── notes.md
エージェントの設定
エージェントの SKILL.md に以下の指示を追加します:
## 保管庫へのアクセス
- 保管庫は `.vaults/` ディレクトリに保存されています。
- 各保管庫は独立したサブディレクトリです。
- ユーザーの明示的な許可なく保管庫の内容を変更しないでください。
補足
- 保管庫のファイル形式はマークダウン
.mdまたはJSON.jsonを使用します。 - 保管庫名にはスペースを含めないでください。
- このスキルは、エージェントがローカルストレージを安全に利用するためのベストプラクティスを提供します。