Command Overview
beacon cloud cursor print-setup prints a Cursor cloud agent setup script for
installing Beacon binaries in the cloud sandbox.
Command syntax
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 run the committed beforeSubmitPrompt project hook after
the cloud environment is available, so Beacon can capture and immediately
upload prompt events. sessionStart and sessionEnd remain unavailable in
Cursor Cloud. 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
vX.Y.Z with the desired release tag. Cursor Cloud prompt capture
requires a release containing the committed beforeSubmitPrompt hook and
immediate upload behavior. Until that release exists, build the branch
containing the change in the cloud environment instead of downloading an older
release.
Related
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 or S3 upload end to end.