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 hooks install

beacon endpoint hooks install installs hook-based Beacon telemetry for supported harnesses. The current public hook harness is Cursor. 
beacon endpoint hooks install --harness cursor --user
The Cursor hook adapter records local endpoint events for sessions, prompt submission, tool use, command execution, MCP-like tool activity, approval decisions, and file edits where Cursor exposes those hook payloads.

​
Examples

Install Cursor hooks at the user level: 
beacon endpoint hooks install --harness cursor --user
Install Cursor hooks at the project level: 
beacon endpoint hooks install --harness cursor --level project --user
Use a custom runtime log: 
beacon endpoint hooks install \
  --harness cursor \
  --user \
  --log-path /path/to/runtime.jsonl

​
Flags

FlagDescription
--userUse per-user endpoint paths instead of system paths
--log-path <path>Runtime JSONL log path
--harness <list>Comma-separated hook harnesses. Defaults to cursor
--level <level>Hook install level: user or project

​
Paths

ItemUser-level installProject-level install
Hook config~/.cursor/hooks.json./.cursor/hooks.json
Hook binary~/.beacon/endpoint/hooks/beacon-hooks~/.beacon/endpoint/hooks/beacon-hooks
Runtime log~/.beacon/endpoint/logs/runtime.jsonl~/.beacon/endpoint/logs/runtime.jsonl
Restart Cursor after installing hooks so the updated hook configuration is picked up.

beacon endpoint hooks status

Check whether Cursor hooks are installed.

beacon endpoint hooks uninstall

Remove Beacon hook entries.