Beacon — самосовершенствующаяся память для AI-кодинг-агентов

Beacon — открытый слой памяти для AI-кодинг-агентов. Он собирает историю сессий из Claude Code, Cursor, Codex, OpenCode и ещё двадцати с лишним харнесов, а затем превращает полезные рабочие приёмы, ваши правки и пути отладки в знания для будущих агентов. Память здесь «самосовершенствующаяся» в прямом смысле: она пополняет сама себя из вашей работы. Девиз проекта объясняет суть в одну строку — задача, которую решил один агент, не должна решаться другим с нуля.

Знания не должны умирать вместе с сессией

Каждая сессия с агентом содержит потенциально полезные знания о проекте:

• правильный способ запуска миграции;
• путь отладки, который наконец привёл к редкой ошибке;
• соглашения в тестах, которые агенты раз за разом нарушают;
• специфичный для репозитория рабочий процесс;
• верная последовательность внутренних инструментов;
• правка, которую вы давали уже нескольким агентам.

Обычно всё это исчезает вместе со старой сессией. Beacon замыкает эти знания в цикл: запуск агентов → захват истории → оценка того, что сработало → извлечение полезного → проверка человеком → повторное использование.

Второй принцип — кросс-харнесовость. Память большинства агентов принадлежит одному инструменту. Beacon стоит над слоем харнесов и нормализует историю из всех них. Сессии в Cursor могут улучшать работу Codex. Сессии Codex — улучшать OpenCode. История накапливается, даже когда вы меняете инструменты. Формулировка авторов: история ваших агентских сессий принадлежит вам, а не харнесу.

Как это устроено

Beacon перехватывает выполнение агентов там, где оно происходит, и приводит всё к единой модели событий на базе OpenTelemetry. В один трейс попадают:

• сессии;
• запросы и ответы модели;
• вызовы инструментов;
• выполненные команды;
• работа с файлами;
• подтверждения действий человеком;
• взаимодействия с MCP;
• расход токенов.

Вместо набора закрытых историй у каждого инструмента получается один датасет. Его можно изучать, искать по нему, учиться на нём и строить поверх него свою обработку.

Установка

Самый короткий путь — попросить настроить самого агента. Вставьте в любой поддерживаемый харнес запрос вида Read https://beacon.sh/start.md then set me up on Beacon.

Вручную на macOS:

brew update
brew trust asymptote-labs/tap
brew tap asymptote-labs/tap
brew install beacon

beacon endpoint install

На Linux есть установочный скрипт для Debian, Ubuntu, Fedora, RHEL, Rocky и Alma. Он скачивает пакет под вашу архитектуру, сверяет его с checksums.txt из релиза и ставит через apt-get или dnf. Скептикам предлагается альтернатива: прочитать скрипт перед запуском или выполнить его шаги вручную — выбрать версию, скачать пакет, проверить контрольные суммы и установить своим пакетным менеджером. Для Windows лежит x64 MSI в последнем релизе.

Установка неинтерактивных сценариев (системные пакеты, MDM, CI) не требует аккаунта.

Локальный просмотр истории

beacon traces открывает локальный терминальный браузер: трейсы, таймлайны событий, расход токенов, сохранённое содержимое. Ничего не уходит из машины. Есть и локальный веб-дашборд — только для чтения:

beacon endpoint dashboard

Каждая страница сессии может показывать «линзы» — готовые представления одного трейса: изменённые файлы с диффами, детальный счёт по токенам, обзор безопасности, сгруппированный по уровням риска, таймлайн подтверждений. Линза — это одиночный HTML-файл в изолированном фрейме: без доступа к Beacon, к дашборду и к обычным сетевым API. Свои линзы можно писать руками агента — команды beacon lenses spec, lint, preview и add. Авторы честно предупреждают: песочница не блокирует все способы отправки данных из браузера, поэтому ставьте только те линзы, которым доверяете.

Под UI лежит обычный JSONL-файл (~/.beacon/endpoint/logs/runtime.jsonl), так что от интерфейса вы не зависите.

Два канала возврата знаний: MCP и Agent Skills

MCP. Команда beacon mcp connect регистрирует MCP-сервер beacon-managed в Claude Code, Codex CLI, Cursor, VS Code, Gemini CLI и OpenCode. Первый вход в каждом харнесе проходит по OAuth — токены нигде не сохраняются. beacon mcp disconnect удаляет ровно то, что добавило подключение, и ничего больше. Через этот сервер агенты ищут по пересланной истории. Есть и отдельный локальный сервер (beacon mcp serve), который вообще не выходит в сеть.

Agent Skills. Мастер настройки ставит Beacon Skills — наборы навыков, которые ищут и сжимают проектную память из трейсов, — в ~/.agents/skills и ~/.claude/skills. Управление: beacon skills install и beacon skills uninstall. Способ установки зависит от среды:

• плагин из маркетплейса — например, /plugin marketplace add asymptote-labs/agent-beacon в Claude Code;
• пакет — pi install git:github.com/asymptote-labs/agent-beacon (Pi, Prime Agent);
• через skills CLI — npx skills add asymptote-labs/agent-beacon;
• каталогом — скопировать agent-skills/skills/* в каталог навыков проекта.

Что захватывается

Локальные агенты — основная история. Полный охват (сессии, промпты, инструменты, команды, файлы, подтверждения, MCP, токены) заявлен для Claude Code и Claude Cowork; близко к нему — Cursor, OpenCode, Cline, Codex CLI, Devin CLI, GitHub Copilot CLI, goose, Gemini CLI и другие. Всего в таблице совместимости около тридцати сред, включая Antigravity CLI, Kimi Code, Qwen Code, OpenHands и VS Code.

Помимо локальных агентов:

• Браузерные чаты. Расширение для Chrome и Firefox захватывает диалоги в Claude.ai и ChatGPT.
• Облачные агенты. Claude Code Cloud Agents и Cursor Cloud Agents через хуки в песочнице с выгрузкой в GCS или S3, Devin Cloud через опрос API.
• CI. Команда beacon ci exec запускает задачу под временным локальным коллектором.
• SDK. Инструментирование Anthropic, OpenAI, Claude Agent SDK и Vercel AI SDK: спаны вызовов модели, ошибки и атрибуты OpenTelemetry.

Куда пересылать телеметрию

По умолчанию всё пишется в локальный JSONL. Тот же нормализованный поток можно пересылать в уже существующую инфраструктуру:

• Beacon Cloud — хостинговая пересылка с режимами Standard или Metadata-only;
• SIEM: Splunk HEC, Microsoft Sentinel, CrowdStrike Falcon LogScale, Sumo Logic, Wazuh, Rapid7 InsightIDR;
• агрегаторы логов: Datadog, Elastic, AWS CloudWatch;
• хранилища: AWS S3, Google Cloud Storage;
• собственные конвейеры — прямая пересылка из локального JSONL.

Заявка понятна: это не только «память для агентов», но и полноценный источник телеметрии для команд, у которых безопасность агентов уже под присмотром SIEM.

Приватность и лицензия

Вход в аккаунт сам по себе ничего не пересылает. Пересылку включает только явное подтверждение варианта Beacon Cloud, причём на экране подтверждения названы аккаунт, оператор (Asymptote Labs), назначение и режим захвата. Вариант Local оставляет всё на машине; отключиться можно в любой момент командой beacon endpoint disconnect.

Проект распространяется по лицензии MIT, работает локально и уже собрал около 2,9 тыс. звёзд на GitHub. Документация живёт на docs.beacon.sh, сообщество — в Discord.

Если коротко: Beacon — это попытка сделать знания агентов накопляемым активом. Не «ещё одна память для одного инструмента», а общий слой между всеми харнесами, с локальным хранением по умолчанию и явным согласием на любое пересылание данных.