Skip to main content

CLI Reference

Complete reference for all dotset commands.

Installation

npm install -g @dotsetlabs/cli

Core Commands

dotset init

Initialize a new dotset project.
dotset init [options]
OptionDescription
--name <name>Project name
--cloudCreate cloud project immediately
--axionEnable Secrets module
--gluonEnable Security module
--hadronEnable Local CI module
--tachyonEnable Tunnels module

dotset run

Run a command with secrets injected and security monitoring enabled.
dotset run [options] -- <command>
OptionDescription
--scope <env>Environment scope: development, staging, production
-s, --service <name>Service to scope secrets to
--no-secretsDisable secret injection
--no-monitorDisable security monitoring
--mode <mode>Protection mode: detect, redact, block

dotset login

Authenticate with the dotset cloud.
dotset login

dotset logout

Clear stored credentials.
dotset logout

dotset status

Show project and authentication status.
dotset status

Secrets Commands

dotset secrets set

Set a secret value.
dotset secrets set <key> [value] [options]
OptionDescription
--scope <env>Environment scope (default: development)
-s, --service <name>Service to scope the secret to

dotset secrets get

Get a secret value.
dotset secrets get <key> [options]

dotset secrets list

List all secrets.
dotset secrets list [options]
OptionDescription
--scope <env>Environment scope
--show-valuesShow secret values (use with caution)

dotset secrets delete

Delete a secret.
dotset secrets delete <key> [options]

Security Commands

dotset scan

Run static security analysis.
dotset scan [options]
OptionDescription
--fixAttempt to fix issues automatically
--jsonOutput results as JSON

dotset sbom

Generate a Software Bill of Materials.
dotset sbom [options]
OptionDescription
--format <format>Output format: cyclonedx, spdx
-o, --output <file>Output file path
--staticGenerate from package.json

CI Commands

dotset ci

Run GitHub Actions jobs locally.
dotset ci [jobs...] [options]
OptionDescription
--workflow <path>Path to workflow file
--scope <env>Environment scope for secrets
--mode <mode>Protection mode: detect, redact, block
--listList available workflows and jobs
--dry-runPreview without executing
--no-secretsDisable secret injection
--no-monitorDisable leak monitoring

Tunnel Commands

dotset share

Share localhost via secure tunnel.
dotset share <port> [options]
OptionDescription
--subdomain <name>Request specific subdomain
--inspectEnable request inspector
--authRequire authentication
--project <id>Link to a specific project

dotset tunnels

List active tunnels.
dotset tunnels