Cairn

Cairn は、型付けされた事実を追加専用で保存するストアです。エージェントがあるセッションで事実を表明し、次のセッションの開始時に鮮度の判定付きでそれを呼び出します。

事実は SQLite に永続化されます。デスクは任意です。処理は JSON と MCP 上で行われます。

インストール

npx cairn init --project
npx cairn dev

init --project は .cairn/cairn.db を作成し、Cursor (.cursor/mcp.json) と Pi (.mcp.json) を設定します。

プロジェクトファイルなしのグローバルインストール:

npx cairn init

Related MCP server: With

コマンド

エージェント契約

POST /api/cairn に JSON を送信するか、MCP ツールの cairn_recall と cairn_request を呼び出します。

すべての書き込みには idempotencyKey が付与されます。クラッシュ後に同じキーとボディをリプレイしても、Cairn は二重に書き込むことなく元の結果を返します。

Recall は各信念に対して freshness と assurance を返します。response.kind で分岐してください。拒否には error.remedy.kind が含まれます。

アサートの例

curl -s http://127.0.0.1:4721/api/cairn \
  -H 'content-type: application/json' \
  -d '{
    "kind": "assert",
    "idempotencyKey": "s-021-deploy",
    "onConflict": "supersede",
    "draft": {
      "entity": "repo:acme/checkout",
      "attribute": "deploy.command",
      "value": { "kind": "text", "text": "bin/ship --env staging" },
      "provenance": {
        "kind": "observed",
        "command": "cat Makefile && bin/ship --help",
        "session": "s-021"
      },
      "validity": { "kind": "until-superseded" }
    }
  }'

ハーネスプラグイン

Cursor. cairn init --project の後、.cursor/mcp.json には npx cairn mcp を実行する cairn サーバーが含まれます。

Pi. 同じ init が Pi および他の MCP クライアント向けに .mcp.json を書き込みます。Pi は .mcp.json と cursor などのホストインポートを読み取ります。

デスクとキャンバス

デスク (/) を開くと、信念テーブルと Agent API コンソールが表示されます。キャンバス (/canvas) を開くと、各エージェントまたはセッションが、彼らが貢献した事実を伴うドラッグ可能なコンテナとして表示されます。

エージェントは、伝えられた事実については provenance.by でグループ化され、観測または推論された事実については provenance.session でグループ化されます。ポッドをドラッグしてボードを配置します。レイアウトは .cairn/canvas.json に永続化されます。

npm からの公開とインストール

npm publish
npx cairn init --project
npx cairn dev

公開された tarball には、完全なデスク、キャンバス、API、CLI、MCP サーバーが同梱されています。Node 20+ が必要です。

開発

npm install
npm test
npm run dev

データベースのパスは、./.cairn/cairn.db ディレクトリが存在する場合はそのパスに解決され、それ以外の場合は ~/.cairn/cairn.db に解決されます。CAIRN_HOME または CAIRN_DB_PATH で上書きできます。

リリーストレーラー (Remotion)

X 向けの約 30 秒の製品トレーラーは cairn-trailer/ にあります。そのフォルダ内で npm run dev でプレビューするか、レンダリング:

cd cairn-trailer
npx remotion render CairnTrailer out/cairn-v0.4-trailer.mp4

推奨投稿コピーについては cairn-trailer/x-post-draft.md を参照してください。

Cairn が拒否するもの

自由形式の JSON 値。セマンティック検索。事実のその場での編集。リクエスト途中での人間の待機。