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.

beacon endpoint repair

beacon endpoint repair reapplies Beacon endpoint service files, collector configuration, and harness telemetry configuration. It is useful after upgrading Beacon, changing ports, or correcting local configuration drift.
beacon endpoint repair --user
Repair preserves runtime logs and harness telemetry configuration while reinstalling managed endpoint files.

Examples

Repair a user-mode install:
beacon endpoint repair --user
Repair and set redacted content retention:
beacon endpoint repair --user --content-retention redacted
Repair with custom OTLP ports:
beacon endpoint repair --user --otlp-grpc-port 14317 --otlp-http-port 14318

Flags

FlagDescription
--userUse 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 a beacon-otelcol binary
--content-retention <mode>Content retention mode: metadata, redacted, or full

beacon endpoint status

Verify endpoint health after repair.

beacon endpoint uninstall

Remove managed endpoint files.