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.

​
Cursor

Beacon supports Cursor through native hook payloads sent to beacon-hooks.

​
Prerequisites

Before enabling Cursor hooks, make sure:
  • Cursor is installed for the user or the ~/.cursor directory exists.
  • beacon endpoint install has run so shared endpoint config and runtime log paths exist.
  • Beacon hooks are installed with beacon endpoint hooks install --harness cursor.
  • For project-level collection, install hooks from the target project with --level project.
  • Cursor is restarted after hook install or removal so new sessions load the updated hook configuration.

​
Collection path

Cursor invokes Beacon’s hook adapter from Cursor hook configuration. The adapter writes normalized endpoint events to the configured runtime JSONL log.

​
Discovery and status

Beacon detects Cursor through the Cursor binary or ~/.cursor, then checks Beacon hook configuration. Use beacon endpoint hooks status --harness cursor to inspect Cursor hook status.

​
Install or configuration support

beacon endpoint install prepares shared endpoint config and runtime log paths. Install Cursor hooks separately: 
beacon endpoint hooks install --harness cursor
For project-level hooks, run: 
beacon endpoint hooks install --harness cursor --level project

​
Telemetry coverage

AreaSupport
Prompt telemetrySupported through beforeSubmitPrompt hooks
Command, tool, and file telemetrySupported for tool, shell command, MCP-like, approval, and file edit payloads where Cursor exposes them
Local JSONL and dashboardSupported
MDM deploymentSupported for the endpoint agent; Cursor hooks are installed separately in the logged-in user’s context

​
Deployment notes

Restart Cursor after installing or removing hooks so the updated hook configuration is picked up by new sessions. Hook events include metadata such as file path, operation, language, diff hash, and diff byte count. Raw diffs follow the configured content-retention mode and are excluded when you choose metadata.

Supported agent harnesses

Return to the runtime support overview.

Hooks

Install, inspect, and uninstall runtime hook integrations.