Skip to main content

Command Overview

beacon cloud cursor print-setup prints a Cursor cloud agent setup script for installing Beacon binaries in the cloud sandbox.
Command syntax
Paste the generated script into the Cursor cloud environment setup step. It installs beacon and beacon-hooks into /tmp/beacon/bin. The generated script does not write or merge .cursor/hooks.json. Generate project hooks with beacon cloud cursor print-hooks, commit .cursor/hooks.json to the repository, then start Cursor Cloud Agents from a commit that contains that file. Cursor cloud agents do not run prompt or session lifecycle hooks such as beforeSubmitPrompt, sessionStart, sessionEnd, and stop. Beacon refreshes the uploaded runtime.jsonl object as supported hook events run. See Cursor’s Cloud Agent hook support matrix for the current platform support list.

Examples

Print setup for a specific Beacon release:
Print setup for a specific Beacon release

beacon cloud

Review cloud command group behavior.

beacon cloud cursor print-hooks

Print project-level Cursor hook settings for a cloud sandbox.

Cursor Cloud Agents

Configure Cursor cloud agent telemetry and GCS upload end to end.