Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint Telemetry

Configure the local Beacon endpoint agent so supported agent harnesses can export telemetry to the local OpenTelemetry Collector and Beacon runtime log.

​
Configure endpoint telemetry

For a non-root local setup, run the default install: 
beacon endpoint install
beacon endpoint status
By default, Beacon configures Claude Code and Codex CLI to export telemetry to a local OpenTelemetry Collector on 127.0.0.1. Gemini CLI telemetry is opt-in; include gemini in the endpoint harness list when you want Beacon to manage local Gemini OTLP settings. Beacon also discovers Gemini CLI, GitHub Copilot CLI, Grok Build, OpenCode, and Factory Droid, can validate Copilot and Droid launch-environment telemetry when you manage those settings through MDM or another customer-owned policy, and can validate OpenClaw Gateway events after you configure Gateway OTLP/HTTP export. 
beacon endpoint install --harness claude,codex,gemini
Production endpoint install is currently supported on macOS. The default mode uses per-user paths; use --system as root for package or MDM deployments.

​
Content retention

By default, Beacon records configured content fields in local or customer-controlled logs. Use metadata when you want endpoint events to exclude prompt text, raw attributes, command output, and raw diffs: 
beacon endpoint install --content-retention metadata
Supported retention modes:
  • full: default; includes configured content fields in local or customer-controlled logs, still subject to event size limits
  • redacted: includes configured content fields after local redaction and size limits
  • metadata: excludes prompt text, raw attributes, command output, and raw diffs
Claude Code, Codex, Gemini CLI, and GitHub Copilot CLI prompt content is exported when retention is set to full or redacted and the runtime emits prompt content. With metadata, Beacon omits prompt text from typed prompt fields, raw attributes, and display messages. Beacon filters generic process/runtime OTLP metrics, Copilot CLI and OpenClaw operational metrics, and high-volume Codex spans out of the local JSONL log by default; use --include-runtime-metrics for low-level metrics, or --include-codex-spans only when you need raw Codex spans for troubleshooting.

Paths

Review files, logs, collector config, ports, and hook locations.

Endpoint agent

Review the endpoint install, status, repair, and uninstall commands.