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.
beacon endpoint install
beacon endpoint install configures the local endpoint agent, writes the OpenTelemetry Collector configuration, installs the launchd service, and configures selected AI runtime harnesses.
Examples
Install in per-user mode:Flags
| Flag | Description |
|---|---|
--user | Use per-user endpoint paths instead of system paths |
--log-path <path> | Runtime JSONL log path |
--harness <list> | Comma-separated harnesses to configure. Defaults to claude,codex |
--otlp-grpc-port <port> | Local OTLP gRPC port. Defaults to 4317 |
--otlp-http-port <port> | Local OTLP HTTP port. Defaults to 4318 |
--collector <path> | Path to an otelcol or otelcol-contrib binary |
--no-start | Write files without starting the launchd service |
--content-retention <mode> | Content retention mode: metadata, redacted, or full |
Paths
| Item | User mode | System mode |
|---|---|---|
| Config | ~/.beacon/endpoint/config.json | /Library/Application Support/Beacon/Endpoint/config.json |
| Base directory | ~/.beacon/endpoint | /Library/Application Support/Beacon/Endpoint |
| Runtime log | ~/.beacon/endpoint/logs/runtime.jsonl | /var/log/beacon-agent/runtime.jsonl |
| Collector config | ~/.beacon/endpoint/otelcol.yaml | /Library/Application Support/Beacon/Endpoint/otelcol.yaml |
Production endpoint install is currently supported on macOS. System mode requires root; use
--user for non-root local installs.Related
beacon endpoint status
Check collector, service, harness, and diagnostic status.
beacon endpoint repair
Reapply endpoint service and telemetry configuration.