---
title: "Agent Beacon: histórico de sessão dos agentes de código em um formato único"
description: "Camada open source da Asymptote Labs que captura sessões de Claude Code, Cursor, Codex e OpenCode, normaliza tudo em eventos baseados em OpenTelemetry e entrega um dashboard local."
canonical: "https://ronanrodrigo.dev/notes/agent-beacon"
markdown: "https://ronanrodrigo.dev/notes/agent-beacon.md"
last-updated: "2026-09-24"
---
## Agent Beacon

Projeto open source (MIT, escrito em Go) da Asymptote Labs que se apresenta como a camada de memória entre harnesses que se auto-aprimora: captura o histórico de sessão de agentes de código — Claude Code, Cursor, Codex, OpenCode, Cline e mais de 20 harnesses — e normaliza prompts, respostas, chamadas de ferramenta, comandos, edições de arquivo, aprovações, atividade MCP e uso de tokens em um único modelo de eventos baseado em OpenTelemetry. Vem com um dashboard local somente leitura (`beacon endpoint dashboard`) e pode encaminhar os mesmos registros para SIEMs corporativos.

[Repositório Asymptote-Labs/agent-beacon](https://github.com/Asymptote-Labs/agent-beacon)

## Documentação e instalação

A documentação oficial cobre instalação e operação: CLI via Homebrew no macOS ou pacote `.pkg` assinado para frotas gerenciadas, `.deb` no Linux, além de configuração de retenção e redação, referência de comandos (`beacon endpoint`, `beacon ci`, `beacon mcp`, `beacon memory`, `beacon scan`) e o caminho de encaminhamento para SIEM.

[Documentação do Beacon](https://docs.beacon.sh)

## Cobertura na Help Net Security

A análise de junho de 2026 descreve o funcionamento por dentro: a ferramenta configura runtimes como Claude Code e Codex CLI para exportar OpenTelemetry para um coletor em `localhost`, que converte logs OTel e eventos de hook em um log JSON normalizado lido pelo dashboard. Destaca ainda que o software roda sem conta na Asymptote, grava telemetria completa por padrão com modos de retenção configuráveis (sem texto de prompt, sem atributos brutos, sem saída de comando, sem diffs), que o dashboard escuta apenas em loopback e que ficam de fora, na versão pública, monitoramento de kernel/processos, histórico de shell e atribuição de uso de credenciais.

[Help Net Security: Agent Beacon, open-source telemetry layer for AI agents](https://www.helpnetsecurity.com/2026/06/22/agent-beacon-open-source-telemetry-layer-ai-agents/)

## Introdução no Substack de Justin D'Souza

O post de lançamento explica o problema que a ferramenta ataca: agentes de código rodam ao lado de credenciais locais, terminais, gerenciadores de pacotes e CLIs de nuvem, e workspaces de agentes como Claude Cowork transformam o notebook do usuário no runtime de trabalho delegado — sem que times de segurança tenham visibilidade do endpoint.

[Introducing Beacon: Endpoint Telemetry for AI Agents](https://justindsouza.substack.com/p/introducing-beacon-endpoint-telemetry)

## Asymptote Labs

A plataforma comercial construída sobre a mesma telemetria aberta: descobre, governa e controla agentes de IA, com rollout via MDM e caminho de visibilidade local para controle corporativo. Útil para entender onde o projeto open source termina e o produto pago começa.

[Asymptote Labs](https://asymptotelabs.ai/)

## Convenções semânticas GenAI do OpenTelemetry

Referência direta para o modelo de dados: as convenções semânticas de GenAI do OpenTelemetry definem atributos e spans para chamadas de modelo, ferramentas e agentes — o padrão que o Agent Beacon estende ao normalizar eventos de harness.

[open-telemetry/semantic-conventions-genai](https://github.com/open-telemetry/semantic-conventions-genai)