Beacon CLI
CLI записывает историю сессий Claude Code, Cursor, Codex и других агентов в одном формате и превращает проверенные уроки в память для следующих сессий
- 2 921 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Записывает промпты, ответы, команды, правки файлов и вывод инструментов всех ваших агентов, а текст с секретом без узнаваемой формы может сохраниться как есть
- Меняет настройки Claude Code, Cursor, Codex и других агентов: подключает хуки, плагины и скиллы, после чего непрерывно пишет сессии в фоне
- Мастер по умолчанию предлагает отправлять журнал в Beacon Cloud, а скиллы умеют загружать сессию на beacon.sh и вызывать сервис оценки
Установка
- Работает в
Ручная установка
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-инструментыCLI и скилл собирают историю сессий кодовых агентов в одну базу SQLite, по которой агент ищет прошлые решения
Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны
Engram от Gentleman Programming
Engram (Gentleman Programming)
Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями
Открытая инфраструктура для агентов, которые учатся на опыте: записи сессий, база знаний и пакеты навыков через CLI, MCP и API
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Beacon (эта запись) | нет | 2 921 | |
| Coding Agent Session Search (cass) | нет | 1 196 | CLI и 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, песочница для проверки установки и документация по приватности и скрытию секретов. Главная страница начинается с идеи общей памяти для агентов и установки, затем идут цикл превращения истории в знания, таблицы поддерживаемых сред и точки назначения журнала.