brain.md — скилл
Постоянная память проекта в Markdown: решения, требования и ограничения лежат в репозитории, и новый сеанс агента их читает.
- 593 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- `brain init` и `brain install-hooks` меняют `CLAUDE.md`, `AGENTS.md` и конфигурацию хуков проекта.
- Память попадает в git вместе с кодом, поэтому секреты в страницы класть нельзя.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/brain-mdОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `brain init` и `brain install-hooks` меняют `CLAUDE.md`, `AGENTS.md` и конфигурацию хуков проекта.
- Память попадает в git вместе с кодом, поэтому секреты в страницы класть нельзя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
brain.md хранит долговечные знания проекта в обычных Markdown-страницах рядом с кодом. Команда `brain init` создает протокольный файл `BRAIN.md`, каталог `brain/` и вписывает блок в `CLAUDE.md` и `AGENTS.md`, поэтому Claude Code, Codex и другие агенты начинают работу с чтения этой памяти. Все изменения идут через небольшой CLI `brain` без зависимостей. `create-page` заводит страницу, `update-truth` переписывает текущее понимание и сразу дописывает строку в хронологию, `read-page` возвращает страницу, `reindex` обновляет индекс. Скилл `brain-bootstrap` наполняет память из кода, документации и `git log` уже живущего проекта.
Для кого. Разработчикам, у которых агент забывает принятые решения в каждом новом сеансе, а причины выбора остаются только в чате.
Подходит, если
- В новом сеансе агент выдвигает вариант, который команда уже отвергла.
- Над проектом работают Claude Code и Codex, и обоим нужна общая память.
- Причину выбора Markdown вместо SQLite хотят сохранить, пока она не забылась.
- В давно живущем проекте решения собирают из кода и истории git.
Не подходит, если
- Нужен поиск по прошлым чатам, а не страницы решений.
- Память должна жить вне репозитория и не попадать в git.
- Проект на один вечер, решений на полгода вперед нет.
Пример запроса к агенту
Сохрани в памяти проекта решение хранить конфиг в Markdown, а не в SQLite, и объясни причину.Ограничения
В README указана версия 0.4.1. CLI написан на Node: без глобальной установки `brain` запускается только через `npx`. Что попадет в память, решает агент или человек по правилу «будет ли это важно через полгода», поэтому без вычитки страницы копят лишнее. Файлы памяти правят только командами `brain`, ручная правка не предусмотрена. `brain init` меняет `CLAUDE.md` и `AGENTS.md` (только помеченный блок), а необязательный pre-commit хук срабатывает при каждом коммите.
Как отключить. Выполните `brain uninstall`: команда убирает глобально установленные скиллы и не трогает данные проектов. Хуки снимают `brain uninstall-hooks`. Блок в `CLAUDE.md` и `AGENTS.md`, каталог `brain/` и `BRAIN.md` удалите сами.
Частые вопросы
Как начать пользоваться?
Поставьте пакет `npm install -g @mindmux/brain-md` и выполните `brain setup -y`, затем `brain init` в корне проекта. Дальше запустите скилл `brain-bootstrap`: он наполнит память из кода и `git log`.
Что лежит на странице памяти?
Переписываемая часть `compiled_truth` с текущим пониманием и хронология `timeline`, куда строки только дописываются. `update-truth` меняет первое и добавляет строку во второе одной атомарной операцией.
Можно ли обойтись без глобальной установки?
Да: `npx @mindmux/brain-md setup -y`, затем `npx @mindmux/brain-md init`. Через `npx` команда `brain` в PATH не попадает, поэтому обе команды запускают так.
Что стоит класть в память?
То, что останется важным через полгода и трудно восстановимо из кода. Детали реализации и все, что видно в коде и истории git, остаются там.
Как подключить Codex?
Выполните `brain install-hooks --agent codex` в корне проекта. Команда создает `.codex/hooks/brain-session-start` и добавляет `SessionStart` в `.codex/hooks.json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДолговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
Скиллы ведут память проекта в папке docs/ai: короткие файлы с лимитом размера, одна страница передачи дел и проверка установки
hipocampus дает агенту файловую память: индекс тем на 3000 токенов грузится в каждую сессию и подсказывает, что обсуждалось раньше
Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны
Локальная панель для Claude Code, Codex, Pi и OpenCode: изменения памяти ждут вашего решения, а после хода идет аудит
Память для агентов одним бинарником на Go: факты переживают сессии, находятся по смыслу и слову, а лишнее со временем угасает
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| brain.md (эта карточка) | нет | 593 | |
| Episodic Memory | нет | 499 | ищет по прошлым разговорам с агентами; brain.md ведет страницы решений с хронологией в репозитории |
| Claude-Mem | нет | 113 534 | сохраняет наблюдения из сессий и подставляет их в новые; brain.md хранит оформленные решения как файлы проекта |
Коротко о README
Репозиторий содержит инструментарий, а не готовую память. Установка копирует скиллы в каталоги найденных агентов, а `brain init` создает память внутри вашего проекта.