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.

beacon endpoint integrations claude-cowork setup

beacon endpoint integrations claude-cowork setup prints the OTLP values to copy into Claude Cowork monitoring settings. It can also open the Claude admin console or create a temporary authenticated ngrok tunnel for local testing.
beacon endpoint integrations claude-cowork setup \
  --endpoint https://otel.example.com \
  --headers "Authorization=Bearer <token>" \
  --user \
  --open

Production setup

For ongoing monitoring, use a durable public HTTPS OpenTelemetry Collector endpoint:
beacon endpoint integrations claude-cowork setup \
  --endpoint https://otel.example.com \
  --headers "Authorization=Bearer <token>" \
  --resource-attributes "deployment.environment=prod,service.name=claude-cowork" \
  --user
Claude Cowork should be configured with:
Claude settingValue
OTLP endpointYour public HTTPS collector endpoint
OTLP protocolHTTP/protobuf
OTLP headersOptional, commonly Authorization=Bearer <token>
Resource attributesDefaults to deployment.environment=prod,service.name=claude-cowork

Local testing with ngrok

For demos, validation, or local development only, create a temporary authenticated ngrok tunnel to the local OTLP HTTP receiver:
beacon endpoint install --user
beacon endpoint integrations claude-cowork setup --ngrok --user --open
Do not use 127.0.0.1, a laptop endpoint, or an ngrok URL for production monitoring.

Flags

FlagDescription
--userUse per-user endpoint paths instead of system paths
--log-path <path>Runtime JSONL log path
--endpoint <url>Public OTLP HTTPS endpoint reachable by Claude Cowork
--headers <headers>Optional OTLP headers for Claude admin settings
--resource-attributes <attrs>Optional Claude Cowork resource attributes
--ngrokCreate a temporary authenticated ngrok tunnel to the local OTLP HTTP receiver
--openOpen Claude Cowork admin settings in a browser

beacon endpoint integrations claude-cowork validate

Validate that Cowork events are arriving.

beacon endpoint integrations claude-cowork status

Show Claude Cowork integration status.