Cairn

Cairn — это хранилище типизированных фактов, в которое можно только добавлять. Агент фиксирует факт в одной сессии и получает его в начале следующей с оценкой свежести.

Факты хранятся в SQLite. desk необязателен. Работа происходит через 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: identity-storage-mcp

Команды

Контракт агента

Отправляйте JSON на POST /api/cairn или вызывайте 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" }
    }
  }'

Плагины Harness

Cursor. После cairn init --project файл .cursor/mcp.json содержит сервер cairn, который запускает npx cairn mcp.

Pi. Тот же init записывает .mcp.json для Pi и других MCP-клиентов. Pi читает .mcp.json и импорты хостов, такие как cursor.

Desk и canvas

Откройте Desk (/), чтобы увидеть таблицу убеждений и консоль Agent API. Откройте Canvas (/canvas), чтобы увидеть каждого агента или сессию в виде перетаскиваемого контейнера с фактами, которые они внесли.

Агенты группируются по provenance.by для сообщённых фактов и по provenance.session для наблюдаемых или выведенных фактов. Перетаскивайте контейнеры, чтобы упорядочить доску; раскладка сохраняется в .cairn/canvas.json.

Публикация и установка из npm

npm publish
npx cairn init --project
npx cairn dev

Опубликованный tarball включает полный desk, canvas, API, CLI и MCP-сервер. Требуется Node 20+.

Разработка

npm install
npm test
npm run dev

Путь к базе данных определяется как ./.cairn/cairn.db, если этот каталог существует, иначе ~/.cairn/cairn.db. Переопределяется с помощью CAIRN_HOME или CAIRN_DB_PATH.

Релизный трейлер (Remotion)

Продуктовый трейлер длительностью ~30 секунд для X находится в 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-значения. Семантический поиск. Изменение фактов на месте. Ожидание человека в середине запроса.