Skip to main content

​
Health Signals

Start local testing by confirming Beacon can find its endpoint configuration, collector, runtime log, and supported harnesses.

​
Run status

beacon endpoint status gives the broadest local view. It reports the Agent Beacon CLI version, config path, runtime log path, collector health, service state, discovered harnesses, diagnostics, destinations, and last observed event. 
beacon endpoint status
For automation or support collection, use JSON output: 
beacon endpoint status --json
If you are validating a system-mode install from a managed package, check system paths with elevated privileges: 
sudo beacon endpoint status --system

​
Run doctor

beacon endpoint doctor runs pass/fail health checks and exits non-zero when a hard check fails. Add --fix when you want Beacon to apply supported safe remediations, such as creating a missing runtime log or repairing managed macOS collector service files. 
beacon endpoint doctor
Doctor verifies the endpoint configuration file, config validity, collector configuration file, runtime JSONL path, runtime log permissions, the macOS launchd plist, and configured harness telemetry. If the runtime log has not been created because no event has been written yet, doctor reports a warning rather than a hard failure. 
beacon endpoint doctor --fix
Fix mode reports any applied and skipped remediations. Skipped findings need operator review, such as invalid endpoint configuration, missing harness setup, missing observed events, unsafe log permissions, or service repair on non-macOS hosts.

​
Discover harnesses

Use discovery to compare configured and detected local runtimes before testing real agent activity. 
beacon endpoint discover --json
Confirm that discovered harnesses match the local test scope. Hook-based runtimes such as Antigravity CLI, Claude Code, Cursor, Devin CLI, Devin Desktop, Factory, Grok Build, Hermes Agent, and OpenCode may require user or project scoped hook installation before real activity appears.

beacon endpoint status

Inspect endpoint health, diagnostics, destinations, and last-event state.

beacon endpoint doctor

Run local health checks with pass/fail exit behavior.

beacon endpoint discover

Show detected and configured local agent harnesses.

Runtime hooks

Install and inspect hook telemetry for supported harnesses.