Skip to main content

​
File Locations

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
Antigravity CLI, Claude Code, Cursor, Devin CLI, Devin Desktop, Factory, Grok Build, Hermes Agent, and OpenCode hooks install an embedded beacon-hooks adapter under the Beacon endpoint base directory. Hook and plugin configuration is written to:
  • Antigravity CLI: ~/.gemini/config/hooks.json or ./.agents/hooks.json
  • Claude Code: ~/.claude/settings.json or ./.claude/settings.json
  • Cursor: ~/.cursor/hooks.json or ./.cursor/hooks.json
  • Devin CLI: ~/.config/devin/config.json or ./.devin/hooks.v1.json
  • Devin Desktop: ~/.codeium/windsurf/hooks.json or ./.windsurf/hooks.json
  • Factory: ~/.factory/settings.json or ./.factory/settings.json
  • Grok Build: ~/.grok/hooks/beacon-endpoint.json or ./.grok/hooks/beacon-endpoint.json
  • Hermes Agent: ~/.hermes/config.yaml
  • OpenCode: ~/.config/opencode/plugins/beacon.ts or ./.opencode/plugins/beacon.ts

Endpoint telemetry

Configure the local endpoint agent and harnesses.

beacon endpoint

Review endpoint command behavior and common paths.