RoBrain CLI

RoBrain пассивно записывает решения команды и агентов и предупреждает, когда агент снова выдвигает уже отвергнутый подход

  • 90 ★ репозитория
  • Последний коммит
  • Apache-2.0
CLI

Широкий доступ

Почему такой уровень

  • Хуки и MCP читают тексты всех ходов сессии и отправляют их внешним моделям для извлечения решений
  • Ставит контейнеры и базу Postgres, пишет `CLAUDE.md`, `AGENTS.md` и правила редакторов в ваш проект
  • В облачном режиме память команды хранится у стороннего сервиса
Все причины и проверки

adelinamart/robrain

Установка

Ручная установка

npx robrain@latest up

Поднимает Postgres и Perception из образа. Нужны Docker и ключи ANTHROPIC_API_KEY и OPENAI_API_KEY.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Хуки и MCP читают тексты всех ходов сессии и отправляют их внешним моделям для извлечения решений
  • Ставит контейнеры и базу Postgres, пишет `CLAUDE.md`, `AGENTS.md` и правила редакторов в ваш проект
  • В облачном режиме память команды хранится у стороннего сервиса

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

RoBrain собирает общую память команды и агентов вместе с причинами решений. Слой Sensing фиксирует ходы сессий, слой Perception вытаскивает из них решения и складывает в Postgres: у каждой записи есть автор, дата, ход сессии и поле отвергнутых вариантов `rejected[]`. Теги вручную не нужны. Пакетный проход Synthesis читает весь корпус и находит противоречия и дрейф позиций. Главное применение: во вторник кто-то в Cursor отказался от переноса на Express, а в среду новый коллега в Claude Code просит этот перенос. RoBrain показывает записанное обоснование до того, как агент пойдет по отвергнутому пути. Свой стек запускает `npx robrain@latest up` (Postgres и Perception из образа), `npx robrain install --self-hosted` подключает MCP Sensing к редакторам, а плагин Claude Code добавляет хуки захвата и предупреждения перед задачей. Облачный режим Rory Plans работает без собственного хостинга. Совместим с Claude Code, Cursor, GitHub Copilot, Codex CLI и Hermes.

Для кого. Командам, где несколько человек и агентов работают над одним кодом и повторно выдвигают то, что уже отвергали, откатывали или признали уязвимым.

Подходит, если

  • Новый коллега в Claude Code просит изменение, которое команда отвергла неделю назад в Cursor
  • Агент не помнит, почему миграцию откатили, и надо показать записанное обоснование до начала работы
  • Нужен журнал решений по файлу: кто, когда и по какому ходу сессии принял решение (`robrain explain`)
  • Раз в неделю нужен проход по всему корпусу решений на противоречия и дрейф командой `robrain synth`

Не подходит, если

  • Вы работаете в одиночку над небольшим проектом: хватит файла `CLAUDE.md` с правилами
  • Нельзя держать Postgres и Docker или у вас нет ключей Anthropic и OpenAI для извлечения решений
  • Нужна только запись общих заметок без учета отвергнутых вариантов

Пример запроса к агенту

Подними RoBrain у меня локально, подключи к Claude Code и покажи решения, которые команда уже отвергла по этому репозиторию

Ограничения

  • Своя установка требует Docker, Postgres и ключи LLM и эмбеддингов: по умолчанию Anthropic для извлечения и OpenAI для векторов, другие связки описаны в `docs/concepts.md`.
  • Запись и извлечение решений идут через внешние модели, поэтому тексты сессий уходят провайдерам, а в облачном режиме и сервису Rory Plans.
  • Облако включено в платные тарифы Rory Plans, самостоятельная установка бесплатна.
  • Заявленные автором цифры VetoBench (ни одного пропуска из 159 прогонов) получены на собственном наборе задач, проверяйте на своих.

Как отключить. Остановите стек командой остановки из `docs/cli.md`, удалите записи `robrain` из конфигурации MCP редакторов и плагин командой `claude plugin uninstall robrain@robrain`. Данные лежат в `~/.robrain/` и в вашей базе Postgres.

Частые вопросы

Как запустить RoBrain у себя?

Задайте ключи Anthropic и OpenAI, затем выполните `npx robrain@latest up` и `npx robrain install --self-hosted`. Команда `up` сама подтянет образ Perception и создаст учетные данные в `~/.robrain/stack/.env`.

Что делает `robrain init-project`?

Записывает в проект `CLAUDE.md`, `AGENTS.md` для Codex CLI и правило `.cursor/rules/robrain.mdc` для Cursor. После этого захват и подстановка прошлых решений идут автоматически.

Чем RoBrain отличается от обычной памяти агента?

Большинство инструментов памяти только сохраняют сказанное. RoBrain ведет происхождение решений, поле отвергнутых вариантов и находит противоречия по всему корпусу.

Как поставить плагин для Claude Code?

Командами `claude plugin marketplace add adelinamart/robrain` и `claude plugin install robrain@robrain`. Плагин дает хуки захвата и предупреждения перед задачей.

Что показывает `robrain explain`?

Историю решений по файлу: кто и когда принял решение, из какого хода сессии оно извлечено и какие варианты отвергнуты.

Обсуждение

Вопросов и отзывов пока нет.

BrainDB хранит память агента в PostgreSQL: сущности, связи, поиск и правила, а два скилла подключают ее к Claude Code.

СкиллРасширенный доступ117Звезды репозитория

MCP-сервер долговременной памяти для агентов: один бинарник на Rust, который работает офлайн и не вызывает языковую модель

MCP-серверШирокий доступ323Звезды репозитория

GBrain хранит факты с источниками, ищет по ним и дает Claude Code, Codex и Cursor общую память, которую владелец правит сам.

ПлагинРасширенный доступ32,8 тыс.Звезды репозитория

Локальная память проекта для ИИ-агентов: репозиторий, сессии и решения в SQLite с метками доказательств, без облака и телеметрии.

CLIРасширенный доступ106Звезды репозитория

Внешняя память для Hermes, Claude Code, Codex и Cursor: архив сессий, слои recall, возврат нужного в контекст без правки агента

CLIРасширенный доступ208Звезды репозитория
Официальный

BrainAPI превращает текст в граф знаний на вашем сервере и отдает агентам через MCP, REST и консоль с ответами по цепочке фактов

MCP-серверШирокий доступ551Звезды репозитория

Коротко о README

README подает RoBrain как слой управления для агентов с общей памятью, происхождением решений и архитектурными ограничениями. Далее идут принцип работы с примером про Hono и Express, два способа установки (свой стек и облако Rory Plans), быстрый старт и разбор бенчмарка VetoBench. Подробности вынесены в `docs`.

Бейдж для README

Сообщить о проблеме