Skip to main content

dotset link

Connect your local project to your dotset cloud dashboard for protection analytics.

Usage

dotset link <project-id> --token <api-token>

Options

OptionDescriptionRequired
-t, --token <token>API token from dashboardYes
--api-url <url>Custom API URL (self-hosted)No

Getting Your Token

  1. Log in to app.dotsetlabs.com
  2. Open your project
  3. Go to API Tokens tab
  4. Click New Token and copy it
Tokens are only shown once. Store them securely.

Example

# Link project
dotset link proj_abc123 --token dss_xxxxx

# Verify connection
dotset status

What Happens

When linked, dotset run automatically sends anonymized telemetry to your dashboard:
  • Command executed (e.g., “npm start”)
  • Secrets count loaded
  • Exposures blocked (secret key names only, never values)
  • Mode used (detect/redact/block)
  • Duration and exit code
No secret values are ever sent to the cloud. Only metadata about protection events.
CommandDescription
dotset unlinkDisconnect from cloud
dotset statusShow connection status

Disable Telemetry

To run a command without reporting:
dotset run --no-telemetry -- npm start