agentcairn — плагин
agentcairn хранит память Claude Code, Codex и Cursor в Markdown-файлах для Obsidian и отдает агенту только нужное
- 75 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки читают транскрипты сессий и записывают их выжимку в `~/agentcairn` открытым текстом, распознанные секреты редактируются, но проверять заметки стоит
- Плагин ставит MCP-сервер и хуки в настройки агентов и меняет конфигурацию MCP с резервной копией
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/agentcairnОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки читают транскрипты сессий и записывают их выжимку в `~/agentcairn` открытым текстом, распознанные секреты редактируются, но проверять заметки стоит
- Плагин ставит MCP-сервер и хуки в настройки агентов и меняет конфигурацию MCP с резервной копией
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agentcairn собирает контекст из сессий кодинг-агентов и записывает его заметками Markdown с указанием источника. Хранилище лежит в `~/agentcairn` и открывается в Obsidian как обычная папка: правка заметки вручную учитывается при следующем чтении. Индекс DuckDB служит только кэшем, его можно удалить и пересобрать, заметки при этом не пострадают. При вызове памяти агент получает результаты поиска BM25 и семантических векторов, объединенные методом Reciprocal Rank Fusion, при желании с реранкингом. Текущий проект получает повышенный вес, заметки других проектов остаются доступны с пометкой. Устаревшие факты не удаляются: поля `valid_from`, `valid_until` и `superseded_by` понижают их в выдаче, но сохраняют историю. На Claude Code плагин ставит MCP-сервер, скилл памяти и хуки: восстановление контекста на каждом ходе и сохранение при завершении сессии или сжатии. Команды `/agentcairn:recall`, `/agentcairn:remember`, `/agentcairn:memory`, `/agentcairn:savings` и `/agentcairn:ingest` работают прямо в чате. Остальные клиенты читают те же заметки через MCP, а `cairn sweep` забирает транскрипты в фоне. Эмбеддинги считаются локально, телеметрии нет.
Для кого. Тем, кто работает с несколькими кодинг-агентами и хочет одну общую память, которую можно читать и править в Obsidian.
Подходит, если
- Работа идет то в Claude Code, то в Codex, и второй агент должен знать, что решил первый
- В проекте накопились договоренности вроде «деплой идет blue-green», и агент каждый раз спрашивает о них заново
- Заметки уже ведутся в Obsidian, и память агента хочется держать там же, в обычных файлах
- Нужно посмотреть, насколько память сокращает контекст: команда `/agentcairn:savings` показывает экономию
Не подходит, если
- Память должна жить в облаке и синхронизироваться между машинами без вашего хранилища
- Нужен граф знаний с автоматически извлеченными сущностями: связи здесь задают вики-ссылки и команда `cairn link`
- Вы работаете только в VS Code с Copilot, где фоновая память недоступна: там работает один MCP без хуков
Пример запроса к агенту
Поставь agentcairn для Claude Code, запомни, что стейджинг выкатывается blue-green, и в новой сессии проверь, что ты это вспомнилОграничения
- Плагин запускается через `uvx`, поэтому сначала нужен uv.
- Первый запуск может скачать и прогреть модели эмбеддингов и реранкинга.
- Фоновая память есть не везде: Cursor и Antigravity получают ее только через `cairn sweep`, а VS Code с Copilot и Claude Desktop работают как обычный MCP-сервер без нее.
- Пустое хранилище ничего не вспомнит, пока агент или вы не записали первые факты командой remember.
Как отключить. Для Claude Code выполните claude plugin uninstall agentcairn@agentcairn, для Codex удалите плагин командой codex plugin. Хранилище `~/agentcairn` останется на диске как обычная папка Markdown, удалить его можно вручную. Кэш DuckDB лежит вне хранилища и пересобирается сам.
Частые вопросы
Как поставить agentcairn в Claude Code?
Выполните claude plugin marketplace add ccf/agentcairn, затем claude plugin install agentcairn@agentcairn. Плагин приносит MCP-сервер, скилл памяти и хуки, отдельный пакет ставить не нужно, но нужен uv.
Где хранятся заметки и можно ли их править руками?
Заметки лежат Markdown-файлами в `~/agentcairn`. Правка вручную учитывается при следующем чтении: индекс DuckDB пересобирается из файлов.
Отправляет ли agentcairn данные наружу?
Нет, телеметрии нет. Эмбеддинги считает локальный FastEmbed, MCP-сервер работает по stdio, внешняя база и демон не нужны. Автоматические записи проходят редактирование распознанных секретов.
Что будет с устаревшим фактом?
Факт остается в хранилище. Поля `valid_until` и `superseded_by` понижают его в выдаче, актуальные записи идут первыми, а история остается доступной для просмотра.
Какие агенты поддерживаются?
Claude Code и Codex получают плагин с хуками, OpenCode получает плагин, Hermes Agent получает провайдер памяти, Cursor и Antigravity подключаются через MCP и фоновый сбор. VS Code с Copilot и Claude Desktop работают как MCP-сервер.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныДолговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Память для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Локальная память для Claude Code, Codex и Claude Desktop: один каталог Markdown и один MCP-сервер на всех.
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
Постоянная память для агентов: заметки хранятся карточками в markdown и находятся в начале следующей сессии.
Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| agentcairn (эта карточка) | нет | 75 | ||
| Claude-Mem | нет | 116 457 | сохраняет сессии Claude Code в собственной базе, файлов Obsidian у него нет | |
| MemPalace | да | не нужна | 60 537 | отдельная система памяти с иной моделью хранения |
| Obsidian Mind | нет | 5 528 | хранилище Obsidian для Claude Code без общей памяти для нескольких агентов |
Коротко о README
Репозиторий открывается обещанием общей памяти для поддерживаемых агентов и ссылками на сайт, PyPI и компаньон для Obsidian. Затем идут команды установки плагина для Claude Code и Codex, мастер подключения через скилл agentcairn-setup и проверка цикла remember и recall. Таблица договора описывает пять обещаний: Markdown как первоисточник, одноразовый индекс, общий для агентов вход, неразрушающая история и контекст у каждого результата. Завершают таблица поддерживаемых агентов и раздел прямого использования.