contextkeeper

contextkeeper

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

---

インストール

pip install contextkeeper

クイックスタート

contextkeeper init
contextkeeper sync --agent claude
contextkeeper 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 contextkeeper import ContextKeeperClient

client = ContextKeeperClient()

# 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": {
    "contextkeeper": {
      "command": "python",
      "args": ["-m", "contextkeeper.mcp"]
    }
  }
}

バックエンド

# File (default) — zero config
contextkeeper init

# SQLite
contextkeeper init --backend sqlite

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

REST API

14 個のエンドポイントと 3 個の認証エンドポイント。OpenAPI 仕様を備えた FastAPI。

contextkeeper 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 レジストリ

ライセンス

MIT © TheRealDataBoss