Beacon CLI

CLI записывает историю сессий Claude Code, Cursor, Codex и других агентов в одном формате и превращает проверенные уроки в память для следующих сессий

  • 2 921 ★ репозитория
  • Последний коммит
  • MIT
CLI

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

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

  • Записывает промпты, ответы, команды, правки файлов и вывод инструментов всех ваших агентов, а текст с секретом без узнаваемой формы может сохраниться как есть
  • Меняет настройки Claude Code, Cursor, Codex и других агентов: подключает хуки, плагины и скиллы, после чего непрерывно пишет сессии в фоне
  • Мастер по умолчанию предлагает отправлять журнал в Beacon Cloud, а скиллы умеют загружать сессию на beacon.sh и вызывать сервис оценки
Все причины и проверки

asymptote-labs/agent-beacon

Установка

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

brew trust asymptote-labs/tap && brew tap asymptote-labs/tap && brew install beacon && beacon endpoint install

Установка на macOS. Мастер предлагает Beacon Cloud, для локальной работы выберите Local.

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

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

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

  • Записывает промпты, ответы, команды, правки файлов и вывод инструментов всех ваших агентов, а текст с секретом без узнаваемой формы может сохраниться как есть
  • Меняет настройки Claude Code, Cursor, Codex и других агентов: подключает хуки, плагины и скиллы, после чего непрерывно пишет сессии в фоне
  • Мастер по умолчанию предлагает отправлять журнал в Beacon Cloud, а скиллы умеют загружать сессию на beacon.sh и вызывать сервис оценки

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

Что делает

Beacon — консольная программа на Go с открытым кодом, которая работает рядом с агентами для программирования и ведет общий журнал их сессий. Команда `beacon endpoint install` ставит сборщик: он подключается к хукам, плагинам и телеметрии Claude Code, Cursor, Codex, OpenCode, Cline, Gemini CLI и еще двух десятков сред и пишет события в единый формат на основе OpenTelemetry. В журнал попадают промпты, ответы, вызовы инструментов, команды, правки файлов, подтверждения, обращения к MCP и расход токенов. Файл `~/.beacon/endpoint/logs/runtime.jsonl` остается у вас на диске, а `beacon traces` показывает его в терминале, `beacon endpoint dashboard` дает локальный веб-интерфейс только для чтения. На основе журнала Beacon строит память проекта. Набор из пяти скиллов (`beacon-memory-recall`, `beacon-memory-distill`, `beacon-memory-promote`, `beacon-lens-create`, `beacon-trace-share`) подтягивает утвержденные уроки перед задачей, отбирает сессии и записывает урок с вашего согласия, а `beacon-memory-promote` сохраняет его как `.agents/skills/<имя>/SKILL.md`, чтобы любая среда загрузила урок сама. Локальный MCP-сервер запускается командой `beacon mcp serve`. Журнал по желанию уходит дальше: в Beacon Cloud на beacon.sh, в Splunk, Datadog, Elastic, Microsoft Sentinel, Wazuh, а также в хранилища S3 и GCS. До отправки секреты по шаблонам заменяются на `[REDACTED]`, а длинные поля обрезаются. Для облака есть режимы приватности «стандартный» и «только метаданные».

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

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

  • Вы переключаетесь между Claude Code, Cursor и Codex, а решения из одной среды надо передавать другой без ручного копирования
  • Нужно разобрать, что агент сделал в сессии: команды, правки, подтверждения и расход токенов в одной ленте
  • Команде нужно отправлять события агентов в Splunk, Datadog или Microsoft Sentinel для расследований и учета
  • Исправления, которые вы повторяете агентам, хочется оформить в проверенные уроки и положить в `.agents/skills`

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

  • Содержимое сессий нельзя хранить даже локально: журнал включает промпты и вывод команд, а шаблонное скрытие секретов не находит пароль без метки
  • Вы работаете в одном агенте, и вам хватает его встроенной памяти: сборщик ради одной среды избыточен
  • Нужен поиск по истории без отдельного сборщика: для готовых журналов Claude Code и Codex ближе Coding Agent Session Search
  • Вы не хотите, чтобы установка меняла настройки агентов: она подключает хуки и плагины, а мастер ставит скиллы в `~/.agents/skills` и `~/.claude/skills`

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

Найди в истории прошлых сессий, как мы решали проблему с миграциями в этом репозитории, и напомни, что сработало

Ограничения

  • Интерактивный мастер `beacon endpoint install` по умолчанию предлагает Beacon Cloud, а не локальный режим. Вход на beacon.sh сам ничего не отправляет, но подтверждение подключения включает пересылку. Чтобы оставить данные на машине, выберите Local. Отключает пересылку `beacon endpoint disconnect`.
  • Скрытие секретов построено на шаблонах: пароль без метки и узнаваемой формы не находится, поэтому сохраненный в журнале текст считайте чувствительным.
  • Поддержка событий неравномерна. Например, для Gemini CLI нет событий сессии и команд, для Codex нет файловых событий. Полная таблица покрытия по средам есть в репозитории.
  • Скилл `beacon-memory-distill` после пробного прогона и вашего согласия обращается к сервису оценки. Скилл `beacon-trace-share` по просьбе загружает сессию на beacon.sh.
  • Доступны Homebrew на macOS, пакеты `.deb` и `.rpm` для Linux и MSI для Windows. Лицензия MIT.

Как отключить. Выполните `beacon endpoint disconnect`, чтобы остановить пересылку, и `beacon skills uninstall`, чтобы убрать скиллы. Подключенное облако MCP снимает `beacon mcp disconnect`. Саму программу удалите менеджером пакетов, например `brew uninstall beacon`. Журнал лежит в `~/.beacon`, его можно удалить вручную.

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

Куда Beacon сохраняет историю сессий?

По умолчанию в локальный файл `~/.beacon/endpoint/logs/runtime.jsonl` в формате JSONL. Пока вы не выбрали облако или внешнюю систему, ничего никуда не отправляется. Просмотр локальный: `beacon traces` в терминале и `beacon endpoint dashboard` в браузере.

Что такое линзы в панели Beacon?

Линза — один HTML-файл, который показывает данные одной сессии: измененные файлы с диффами, подсчет токенов, разбор по уровню опасности, ленту подтверждений. Она работает в изолированном фрейме. Автор предупреждает, что песочница закрывает не все способы утечки, поэтому ставьте только доверенные линзы.

Как работает память проекта?

Скилл `beacon-memory-distill` предлагает сессии, проверяет их встроенной оценкой после пробного прогона и вашего согласия, читает исходную запись и формулирует урок с опорой на нее. Вы утверждаете урок вместе с агентом. `beacon-memory-recall` перед задачей достает утвержденные уроки, а `beacon-memory-promote` оформляет их в обычный скилл.

Можно ли записывать чат в браузере?

Да, для claude.ai и ChatGPT есть расширение для браузеров на Chromium и Firefox. Оно передает промпты, ответы и вызовы инструментов на локальный сборщик OTLP на вашей машине. Расход токенов для claude.ai оценивается приблизительно, для ChatGPT не фиксируется.

Как Beacon работает в непрерывной интеграции?

Команда `beacon ci exec` запускает задачу с временным локальным сборщиком и записывает сессию, команды, файлы и токены. В репозитории лежит `action.yml` для GitHub Actions. Для облачных агентов Claude Code и Cursor снимок сессии уходит через хуки песочницы в хранилище GCS или S3.

Сколько сред поддерживает Beacon?

Больше двадцати локальных: от Antigravity CLI и Claude Code до OpenHands и Qwen Code. Для каждой в таблице репозитория указан способ сбора (хуки, OTLP, опрос, плагин) и какие типы событий поддерживаются. Среди облачных агентов есть Claude Code, Cursor и Devin.

Обсуждение

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

CLI и скилл собирают историю сессий кодовых агентов в одну базу SQLite, по которой агент ищет прошлые решения

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

Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями

MCP-серверРасширенный доступ334Звезды репозитория

Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны

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

Engram от Gentleman Programming

Engram (Gentleman Programming)

Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями

MCP-серверРасширенный доступ7,7 тыс.Звезды репозитория

Открытая инфраструктура для агентов, которые учатся на опыте: записи сессий, база знаний и пакеты навыков через CLI, MCP и API

ПлагинШирокий доступ340Звезды репозитория

Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом

MCP-серверРасширенный доступ4,4 тыс.Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
Beacon (эта запись)нет2 921
Coding Agent Session Search (cass)нет1 196CLI и TUI для поиска по локальной истории сессий, с режимом --robot для самих агентов
Claude Code History Viewerнет2 289настольное приложение для просмотра и анализа истории разговоров разных агентов
Mem0нет68 007слой памяти для агентов с плагинами, CLI и SDK для переноса контекста между сессиями

Коротко о README

В репозитории лежат исходники CLI и сборщика на Go, плагин с пятью скиллами памяти и манифестами для Claude Code, Codex, Cursor, Gemini CLI и других сред, расширение для браузера, пакеты для macOS, Linux и Windows, песочница для проверки установки и документация по приватности и скрытию секретов. Главная страница начинается с идеи общей памяти для агентов и установки, затем идут цикл превращения истории в знания, таблицы поддерживаемых сред и точки назначения журнала.

Бейдж для README

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

Foxx AIBeacon
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.