Skip to main content

dotset doctor

Run diagnostics to verify that all Dotset tools are properly installed and configured.

Usage

dotset doctor [options]

Options

OptionDescription
--installAuto-install missing Go binaries (Hardpoint, Deadfall)

Examples

# Check installation status
dotset doctor

# Auto-install missing tools
dotset doctor --install

What It Checks

The doctor command verifies:
CheckDescription
ConfigurationLooks for dotset.yaml and validates syntax
Hardpoint binaryChecks if Go binary is installed
Deadfall binaryChecks if Go binary is installed
TollgateChecks if npm package is available
Node.jsVerifies Node.js version (requires 20+)

Example Output

$ dotset doctor

Dotset Doctor

Diagnostics:

 Configuration: Found dotset.yaml
 Config Validity: Configuration is valid
 hardpoint binary: /home/user/.dotset/bin/hardpoint
 deadfall binary: /home/user/.dotset/bin/deadfall
 Tollgate: npm package available
 Node.js: v20.10.0

All checks passed!

Auto-Install

When you run dotset doctor --install, missing Go binaries are automatically downloaded:
$ dotset doctor --install

Dotset Doctor

Installing hardpoint...
  Downloading hardpoint v0.1.0 for linux/amd64...
  Installed to /home/user/.dotset/bin/hardpoint
Installing deadfall...
  Downloading deadfall v0.1.0 for linux/amd64...
  Installed to /home/user/.dotset/bin/deadfall

Diagnostics:

 Configuration: Found dotset.yaml
 hardpoint binary: Installed to /home/user/.dotset/bin/hardpoint
 deadfall binary: Installed to /home/user/.dotset/bin/deadfall
 Tollgate: npm package available
 Node.js: v20.10.0

All checks passed!

Exit Codes

CodeMeaning
0All checks passed
1One or more checks failed

See Also