Skip to main content

CLI Reference

The shield CLI provides a unified interface for secret protection and cloud analytics.

Commands

CommandDescription
runRun commands with protection
linkConnect project to cloud
secretsManage local encrypted storage
ciRun local CI (GitHub Actions)
authAuthenticate with cloud

Cloud Commands

CommandDescription
dotset link <id> --token <t>Connect to dashboard
dotset shield unlinkDisconnect from cloud
dotset shield statusShow connection status
dotset shield syncFetch security policies from cloud

Global Options

dotset shield --version    # Show version
dotset shield --help       # Show help

Quick Examples

# Zero-setup protection
dotset shield run -- npm start

# Redact secrets from output
dotset shield run --mode redact -- npm test

# Link to cloud for analytics
dotset link proj_123 --token dss_xxx

# Run with telemetry
dotset shield run --mode redact -- npm start
# Analytics appear at app.dotsetlabs.com

# Disable telemetry for a run
dotset shield run --no-telemetry -- npm start