sklpdocs

sklp deploy ls

sklp deploy ls [flags]

Description

List running instances of a deploy

Flags

FlagAliasesTypeDefaultEnvDescription
--file—string——(deprecated, ignored) ls queries the live supervisor
--repo—string——(deprecated, ignored) ls queries the live supervisor
--space—string——space to inspect (empty = every live space on this host)
--json—bool——emit JSON on stdout (the form for scripts and AI agents)
--server-addrstring——remote supervisor control API (https://host:9443); when set, pilot it over the network instead of the local socket
--token—string——Bearer token for --server (prefer --token-file or SKLP_CONTEXT_TOKEN to keep it out of the process list)
--token-file—string——file holding the Bearer token for --server
--ca-fingerprint—string——pin the server certificate by its sha256 fingerprint (printed by the server / `sklp deploy fingerprint`)
--insecure—bool——skip TLS verification for --server (LAN bootstrap only; prefer --ca-fingerprint)
--context—string——deploy context to read server/token/ca-fingerprint from (default: the active context)
--config—string——path to a config file to read (one file per node/VM, e.g. lungor.yaml); overrides the default ~/.config/sklp/config.yaml

Technical details

Technical details

Raw command JSON

{
  "path": [
    "sklp",
    "deploy",
    "ls"
  ],
  "slug": "deploy-ls",
  "name": "ls",
  "short": "List running instances of a deploy",
  "synopsis": "sklp deploy ls [flags]",
  "flags": [
    {
      "name": "file",
      "usage": "(deprecated, ignored) ls queries the live supervisor",
      "type": "string"
    },
    {
      "name": "repo",
      "usage": "(deprecated, ignored) ls queries the live supervisor",
      "type": "string"
    },
    {
      "name": "space",
      "usage": "space to inspect (empty = every live space on this host)",
      "type": "string"
    },
    {
      "name": "json",
      "usage": "emit JSON on stdout (the form for scripts and AI agents)",
      "type": "bool"
    },
    {
      "name": "server",
      "aliases": [
        "addr"
      ],
      "usage": "remote supervisor control API (https://host:9443); when set, pilot it over the network instead of the local socket",
      "type": "string"
    },
    {
      "name": "token",
      "usage": "Bearer token for --server (prefer --token-file or SKLP_CONTEXT_TOKEN to keep it out of the process list)",
      "type": "string"
    },
    {
      "name": "token-file",
      "usage": "file holding the Bearer token for --server",
      "type": "string"
    },
    {
      "name": "ca-fingerprint",
      "usage": "pin the server certificate by its sha256 fingerprint (printed by the server / `sklp deploy fingerprint`)",
      "type": "string"
    },
    {
      "name": "insecure",
      "usage": "skip TLS verification for --server (LAN bootstrap only; prefer --ca-fingerprint)",
      "type": "bool"
    },
    {
      "name": "context",
      "usage": "deploy context to read server/token/ca-fingerprint from (default: the active context)",
      "type": "string"
    },
    {
      "name": "config",
      "usage": "path to a config file to read (one file per node/VM, e.g. lungor.yaml); overrides the default ~/.config/sklp/config.yaml",
      "type": "string"
    }
  ]
}

See also