Endpoint Paths and Ports

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.

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`
Rotated runtime archives	`~/.beacon/endpoint/logs/runtime.jsonl.1` through `.5`	`/var/log/beacon-agent/runtime.jsonl.1` through `.5`
Threat rule store	`~/.beacon/endpoint/rules`	`/Library/Application Support/Beacon/Endpoint/rules`
Collector config	`~/.beacon/endpoint/otelcol.yaml`	`/Library/Application Support/Beacon/Endpoint/otelcol.yaml`
OTLP gRPC	`127.0.0.1:4317`	`127.0.0.1:4317`
OTLP HTTP	`127.0.0.1:4318`	`127.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:

Runtime	Global config path	Project-local config path
Antigravity CLI	`~/.gemini/config/hooks.json`	`./.agents/hooks.json`
Claude Code	`~/.claude/settings.json`	`./.claude/settings.json`
Cursor	`~/.cursor/hooks.json`	`./.cursor/hooks.json`
Devin CLI	`~/.config/devin/config.json`	`./.devin/hooks.v1.json`
Devin Desktop	`~/.codeium/windsurf/hooks.json`	`./.windsurf/hooks.json`
Factory	`~/.factory/settings.json`	`./.factory/settings.json`
Grok Build	`~/.grok/hooks/beacon-endpoint.json`	`./.grok/hooks/beacon-endpoint.json`
Hermes Agent	`~/.hermes/config.yaml`	—
OpenCode	`~/.config/opencode/plugins/beacon.ts`	`./.opencode/plugins/beacon.ts`

Endpoint telemetry

Configure the local endpoint agent and harnesses.

beacon endpoint

Review endpoint command behavior and common paths.

Install and Upgrade

CLI Resources

Command Manual

Endpoint Paths and Ports

File Locations

Endpoint telemetry

beacon endpoint

​File Locations

​Related

Endpoint telemetry

beacon endpoint

File Locations

Related