Skip to main content

​
Command Overview

beacon cloud cursor print-hooks prints project-level Cursor hook settings for a cloud sandbox. Commit the rendered JSON to .cursor/hooks.json before starting Cursor Cloud Agents.
Command syntax
The rendered hooks set BEACON_ORIGIN=cloud, BEACON_RUN_PROVIDER=cursor_cloud, and BEACON_RUN_EPHEMERAL=true for Cursor cloud hook events. Cursor Cloud only runs command-based project hooks after the cloud VM starts. The generated hook set uses supported Cursor Cloud hooks such as beforeReadFile, beforeShellExecution, afterShellExecution, afterFileEdit, postToolUse, postToolUseFailure, subagentStart, subagentStop, and preCompact. It does not include broad preToolUse, beforeSubmitPrompt, sessionStart, sessionEnd, or stop because Cursor does not run those hooks in cloud agents. See Cursor’s Cloud Agent hook support matrix for the current platform support list. Beacon uses Cursor’s conversation_id hook payload as the default run.run_id for Cursor Cloud telemetry unless BEACON_RUN_ID is already set.

​
Examples

Print hook settings for a cloud sandbox:
Print hook settings for a cloud sandbox

beacon cloud

Review cloud command group behavior.

beacon cloud cursor print-setup

Print a Cursor cloud agent binary setup script.