Skip to main content

​
Overview

beacon cloud prints setup helpers for provider-managed cloud agent environments. Supported flows capture Claude Code or Cursor cloud agent telemetry and upload the cloud session’s runtime.jsonl to customer-managed Google Cloud Storage. For complete walkthroughs, see Claude Code Cloud Agents and Cursor Cloud Agents.

​
claude-web print-setup

Print a Claude Code cloud environment setup script for a Beacon release: 
beacon cloud claude-web print-setup --version v0.0.51
Paste the generated script into the Claude Code cloud environment setup field. It installs beacon and beacon-hooks into /tmp/beacon/bin, discovers the cloud sandbox repository root, and writes .claude/settings.local.json inside the sandbox clone.

​
claude-web print-hooks

Print the Claude hook settings used by the setup script: 
beacon cloud claude-web print-hooks \
  --binary-path /tmp/beacon/bin/beacon-hooks \
  --log-path /tmp/beacon/runtime.jsonl
This command is mostly useful for debugging or custom setup scripts.

​
cursor print-setup

Print a Cursor cloud agent environment setup script for a Beacon release: 
beacon cloud cursor print-setup --version v0.0.52
Paste the generated script into the Cursor cloud environment setup step. It installs beacon and beacon-hooks into /tmp/beacon/bin, discovers the cloud sandbox repository root, and merges Beacon hook commands into .cursor/hooks.json.

​
cursor print-hooks

Print project-level Cursor hook settings for a cloud sandbox: 
beacon cloud cursor print-hooks \
  --binary-path /tmp/beacon/bin/beacon-hooks \
  --log-path /tmp/beacon/runtime.jsonl
The rendered hooks set BEACON_ORIGIN=cloud, BEACON_RUN_PROVIDER=cursor_cloud, and BEACON_RUN_EPHEMERAL=true for Cursor cloud hook events.

​
cursor install-hooks

Merge Beacon hooks into project-level Cursor cloud hook settings: 
beacon cloud cursor install-hooks \
  --binary-path /tmp/beacon/bin/beacon-hooks \
  --log-path /tmp/beacon/runtime.jsonl \
  --hooks-json .cursor/hooks.json
Use install-hooks from setup scripts when .cursor/hooks.json may already contain non-Beacon hooks. The command preserves unrelated hook entries and replaces older Beacon-managed Cursor hook commands.

​
gcs setup

Create or print self-serve GCS setup commands for cloud-agent telemetry: 
beacon cloud gcs setup \
  --project "$GCP_PROJECT" \
  --bucket "$BEACON_CLOUD_GCS_BUCKET" \
  --prefix "$BEACON_CLOUD_GCS_PREFIX" \
  --service-account beacon-cloud-trace-uploader \
  --apply \
  --print-env
The helper creates or validates a bucket, creates a dedicated uploader service account, grants object upload access, creates a service-account key, and prints the BEACON_CLOUD_GCS_* environment variables for cloud agents.
This self-serve flow passes a scoped Google service-account key into the provider-managed cloud agent environment. Use it for proof-of-concept testing and prototyping. For production enterprise deployments, use Asymptote Managed or contact Asymptote about secure forwarding in customer-managed infrastructure.

Claude Code Cloud Agents

Configure Claude Code cloud agent telemetry and GCS upload end to end.

Cursor Cloud Agents

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

Google Cloud Storage forwarding

Review local endpoint GCS forwarding for persistent endpoint deployments.