vaultit

vaultit

mcp-name: io.github.TheRealDataBoss/vaultit

AI エージェント間のモデルドリフトをゼロに。

---

インストール

pip install vaultit

クイックスタート

vaultit init
vaultit sync --agent claude
vaultit bootstrap --clipboard
# paste into any AI — full context restored

CLI リファレンス

コマンド	説明
init	プロジェクトのコンテキスト（状態ベクトル、規約、タスク）をひな形から作成します
sync	リポジトリをスキャンし、現在のプロジェクト状態を反映して状態ベクトルを更新します
bootstrap	どの AI エージェントにも貼り付けて使えるブリーフィングを生成します
status	追跡中のプロジェクトと現在の状態を表示します
doctor	コンテキストファイルの整合性と必須項目の欠落を検証します
migrate	データベースのスキーママイグレーションを実行します
export	プロジェクトのコンテキストを JSON/Markdown にエクスポートします
diff	前回の同期以降に変更された内容を表示します
serve	REST API サーバー（FastAPI + Uvicorn）を起動します
sessions	エージェントセッションの一覧表示と管理を行います
tasks	プロジェクトタスクの一覧表示と管理を行います
decisions	アーキテクチャ上の決定事項の一覧表示と管理を行います
auth	API キーを作成および失効します（ck_ プレフィックス、SHA-256 で保存）

Python SDK

from vaultit import VaultItClient

client = VaultItClient()

# Sessions
session = client.create_session(agent="claude", project="myproject")
client.end_session(session.id, summary="Implemented auth module")

# Tasks & decisions
client.create_task(project="myproject", title="Add rate limiting")
client.create_decision(project="myproject", title="Use PostgreSQL", rationale="Need JSONB")

# Handoff
handoff = client.create_handoff(from_session=s1.id, to_agent="gpt-4")

MCP サーバー

10 個のツール — Model Context Protocol による Claude Code とのネイティブ連携。

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "vaultit": {
      "command": "python",
      "args": ["-m", "vaultit.mcp"]
    }
  }
}

バックエンド

# File (default) — zero config
vaultit init

# SQLite
vaultit init --backend sqlite

# PostgreSQL
vaultit init --backend postgres --db-url postgresql://user:pass@localhost/ck

REST API

14 個のエンドポイントと 3 個の認証エンドポイント。OpenAPI 仕様に対応した FastAPI を使用しています。

vaultit serve --port 8420
# → http://localhost:8420/docs   (Swagger UI)
# → http://localhost:8420/openapi.json

認証ヘッダー：Authorization: Bearer ck_your_api_key

マルチエージェント連携

エージェントが同時にアクセスするための 3 つのモード：

• sequential — 一度に 1 つのエージェントがアクセスします（デフォルト）
• lock-based — リソースごとの悲観的ロック
• merge — 競合解決を伴う楽観的マージ

リンク

• GitHub
• ドキュメント
• PyPI
• MCP Registry

ライセンス

MIT © TheRealDataBoss