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.

​
Paths

Beacon manages different paths depending on whether you install in user mode or system mode. The active runtime log stays at runtime.jsonl and rotates at 10 MiB, retaining five numbered local archives by default.
ItemUser modeSystem 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
Rotated runtime archives~/.beacon/endpoint/logs/runtime.jsonl.1 through .5/var/log/beacon-agent/runtime.jsonl.1 through .5
Collector config~/.beacon/endpoint/otelcol.yaml/Library/Application Support/Beacon/Endpoint/otelcol.yaml
OTLP gRPC127.0.0.1:4317127.0.0.1:4317
OTLP HTTP127.0.0.1:4318127.0.0.1:4318
Cursor, Devin, Factory, Grok Build, and OpenCode hooks install an embedded beacon-hooks adapter under the Beacon endpoint base directory. Hook and plugin configuration is written to:
  • Cursor: ~/.cursor/hooks.json or ./.cursor/hooks.json
  • Devin: ~/.config/devin/config.json or ./.devin/hooks.v1.json
  • Factory: ~/.factory/settings.json or ./.factory/settings.json
  • Grok Build: ~/.grok/hooks/beacon.json or ./.grok/hooks/beacon.json
  • OpenCode: ~/.config/opencode/plugins/beacon.ts or ./.opencode/plugins/beacon.ts

Endpoint telemetry

Configure the local endpoint agent, harnesses, and content retention.

beacon endpoint

Review endpoint command behavior and common paths.