Cairn

Cairn ist ein Append-only-Speicher für typisierte Fakten. Ein Agent erfasst in einer Sitzung einen Fakt und ruft ihn zu Beginn der nächsten Sitzung mit einer Frische-Bewertung ab.

Fakten werden in SQLite dauerhaft gespeichert. Das Desk ist optional. Die Arbeit erfolgt über JSON und MCP.

Installation

npx cairn init --project
npx cairn dev

init --project erstellt .cairn/cairn.db, konfiguriert Cursor (.cursor/mcp.json) und konfiguriert Pi (.mcp.json).

Globale Installation ohne Projektdatei:

npx cairn init

Related MCP server: With

Befehle

Agentenvertrag

Sende JSON an POST /api/cairn oder rufe die MCP-Tools cairn_recall und cairn_request auf.

Jeder Schreibvorgang trägt einen idempotencyKey. Wenn nach einem Absturz derselbe Key und Body erneut gesendet werden, gibt Cairn das ursprüngliche Ergebnis zurück, ohne doppelt zu schreiben.

Der Abruf liefert für jede Überzeugung freshness und assurance. Verzweige anhand von response.kind. Ablehnungen enthalten error.remedy.kind.

Beispiel: Fakt erfassen

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" }
    }
  }'

Harness-Plugins

Cursor. Nach cairn init --project enthält .cursor/mcp.json einen cairn-Server, der npx cairn mcp ausführt.

Pi. Dieselbe Initialisierung schreibt .mcp.json für Pi und andere MCP-Clients. Pi liest .mcp.json und Host-Importe wie cursor.

Desk und Canvas

Öffne Desk (/) für die Tabelle der Überzeugungen und die Agent-API-Konsole. Öffne Canvas (/canvas), um jeden Agenten oder jede Sitzung als verschiebbaren Container mit den Fakten zu sehen, die sie beigetragen haben.

Die Gruppierung erfolgt für mitgeteilte Fakten nach provenance.by und für beobachtete oder abgeleitete Fakten nach provenance.session. Ziehe die Karten, um das Board anzuordnen; das Layout wird in .cairn/canvas.json gespeichert.

Veröffentlichen und über npm installieren

npm publish
npx cairn init --project
npx cairn dev

Das veröffentlichte Tarball enthält Desk, Canvas, API, CLI und MCP-Server in vollem Umfang. Es ist Node 20+ erforderlich.

Entwicklung

npm install
npm test
npm run dev

Der Datenbankpfad wird zu ./.cairn/cairn.db aufgelöst, wenn dieses Verzeichnis existiert, andernfalls zu ~/.cairn/cairn.db. Überschreiben lässt sich das mit CAIRN_HOME oder CAIRN_DB_PATH.

Release-Trailer (Remotion)

Ein ca. 30 Sekunden dauernder Produkttrailer für X liegt in cairn-trailer/. Vorschau mit npm run dev in diesem Ordner – alternativ rendern:

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

Siehe cairn-trailer/x-post-draft.md für einen Textvorschlag für den Post.

Was Cairn ablehnt

Beliebige JSON-Werte. Semantische Suche. Vorhandene Fakten direkt ändern. Mitten in einer Anfrage auf einen Menschen warten.