Skip to main content

​
dotset status

Display the current status of all Dotset tools, including installation status, versions, and configuration.

​
Usage

dotset status [options]

​
Options

OptionDescription
--jsonOutput status as JSON

​
Examples

# Show status in terminal
dotset status

# Output as JSON (for scripting)
dotset status --json

​
Example Output

$ dotset status

Dotset Status

Tools:
  ✓ hardpoint v0.1.0 (Go)
    /home/user/.dotset/bin/hardpoint
  ✓ deadfall v0.1.0 (Go)
    /home/user/.dotset/bin/deadfall
  ✓ tollgate v1.2.0 (npm)

Configuration:
  ✓ dotset.yaml (valid)

Environment:
  Node.js: v20.10.0

All 3 tools installed.

​
JSON Output

When using --json, the output is structured for programmatic use: 
$ dotset status --json

{
  "tools": [
    {
      "name": "hardpoint",
      "installed": true,
      "version": "0.1.0",
      "path": "/home/user/.dotset/bin/hardpoint",
      "type": "go-binary"
    },
    {
      "name": "deadfall",
      "installed": true,
      "version": "0.1.0",
      "path": "/home/user/.dotset/bin/deadfall",
      "type": "go-binary"
    },
    {
      "name": "tollgate",
      "installed": true,
      "version": "1.2.0",
      "type": "npm-package"
    }
  ],
  "config": {
    "found": true,
    "path": "dotset.yaml",
    "valid": true
  },
  "nodeVersion": "v20.10.0"
}

​
Tool Types

TypeDescription
go-binaryStandalone Go binary (Hardpoint, Deadfall)
npm-packageNode.js package (Tollgate)

​
Missing Tools

If tools are not installed, the status command shows what’s missing: 
$ dotset status

Dotset Status

Tools:
  ✗ hardpoint not installed (Go)
  ✗ deadfall not installed (Go)
  ✓ tollgate v1.2.0 (npm)

Configuration:
  ─ No dotset.yaml found (using defaults)

Environment:
  Node.js: v20.10.0

1/3 tools installed.
Run `dotset doctor --install` to install missing tools.

​
See Also