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.
Cursor Hooks
Beacon can install hook-based endpoint telemetry for Cursor. The hook adapter emits local Beacon events for sessions, prompt submission, tool use, command execution, MCP-like tool activity, approval decisions, and file edits where Cursor exposes those hook payloads.Commands
beacon endpoint hooks install
Install endpoint hooks for Cursor.
beacon endpoint hooks status
Show endpoint hook integration status.
beacon endpoint hooks uninstall
Remove Beacon hook entries while preserving non-Beacon hooks.
Paths
| Item | User-level install | Project-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 |
/Library/Application Support/Beacon/Endpoint/hooks/ and the default runtime log is /var/log/beacon-agent/runtime.jsonl.
Flags
| Flag | Description |
|---|---|
--harness <list> | Comma-separated hook harnesses. Defaults to cursor |
--level <level> | Hook install level: user or project |
--user | Use per-user endpoint paths. Enabled by default |
--system | Use system endpoint paths and launch daemon |
--log-path <path> | Runtime JSONL log path |
--json | Print status as JSON. Status only |
Restart Cursor after installing or removing hooks so the updated hook configuration is picked up.