Skip to main content
Version: Next

thresh cluster

New in v1.7.0

The cluster command group is new in thresh 1.7.0. Requires an authenticated session — run thresh auth login first.

Organize your fleet nodes into named clusters for grouped management. Clusters are logical groupings — they don't change how agents connect, but they make it easier to manage large fleets by region, team, or purpose.

Prerequisites​

  • An authenticated CLI session (thresh auth login)
  • One or more nodes in your account (thresh node list)

Subcommands​

SubcommandDescription
cluster listList all clusters in your account
cluster createCreate a new cluster
cluster infoShow cluster details and live node metrics
cluster add-nodeAdd a node to a cluster
cluster remove-nodeRemove a node from a cluster
cluster deleteDelete a cluster

thresh cluster list​

List all clusters in your Hub account.

Synopsis​

thresh cluster list [--hub <url>]

Options​

OptionDescription
--hub <url>Hub URL (overrides stored credentials)

Example​

thresh cluster list
NAME          NODES  DESCRIPTION              CREATED
production    3      Production fleet          2 weeks ago
staging       2      Staging / QA nodes        1 week ago
dev-team      1      Developer workstations    3 days ago

thresh cluster create​

Create a new empty cluster.

Synopsis​

thresh cluster create <name> [--description <desc>] [--hub <url>]

Arguments​

ArgumentDescription
nameCluster name (must be unique within account)

Options​

OptionDescription
--description <desc>Optional description
--hub <url>Hub URL (overrides stored credentials)

Example​

thresh cluster create production --description "Production fleet nodes"
✓ Cluster 'production' created

thresh cluster info​

Show cluster details including all member nodes and their live metrics.

Synopsis​

thresh cluster info <cluster> [--hub <url>]

Arguments​

ArgumentDescription
clusterCluster name or ID

Example​

thresh cluster info production
Cluster: production
Description: Production fleet nodes
Nodes: 3
──────────────────────────────────────────────────

HOSTNAME          STATUS   CPU    MEM      DISK    ENVS
thresh-node-1     online   12%    4.2 GB   45%     3
thresh-node-2     online    8%    2.1 GB   32%     2
thresh-node-4     online   22%    6.8 GB   58%     5

Totals:  CPU avg 14%  |  MEM 13.1 GB  |  10 environments

thresh cluster add-node​

Add an existing node to a cluster. A node can belong to one cluster at a time.

Synopsis​

thresh cluster add-node <cluster> <node> [--hub <url>]

Arguments​

ArgumentDescription
clusterCluster name or ID
nodeNode hostname or agent ID

Example​

thresh cluster add-node production thresh-node-1
✓ Node 'thresh-node-1' added to cluster 'production'

thresh cluster remove-node​

Remove a node from a cluster. The node remains connected to the Hub — it is only removed from the cluster grouping.

Synopsis​

thresh cluster remove-node <cluster> <node> [--hub <url>]

Arguments​

ArgumentDescription
clusterCluster name or ID
nodeNode hostname or agent ID

Example​

thresh cluster remove-node production thresh-node-3
✓ Node 'thresh-node-3' removed from cluster 'production'

thresh cluster delete​

Delete a cluster. The member nodes are not removed from the Hub — they simply become unassigned.

Synopsis​

thresh cluster delete <cluster> [--force] [--hub <url>]

Arguments​

ArgumentDescription
clusterCluster name or ID

Options​

OptionDescription
--forceSkip confirmation prompt
--hub <url>Hub URL (overrides stored credentials)

Example​

thresh cluster delete staging
Delete cluster 'staging'? Nodes will not be affected. [y/N] y
✓ Cluster 'staging' deleted

Use Cases​

By Region​

thresh cluster create us-east --description "US East Coast nodes"
thresh cluster create us-west --description "US West Coast nodes"
thresh cluster create eu-central --description "EU Frankfurt nodes"

thresh cluster add-node us-east thresh-node-1
thresh cluster add-node us-east thresh-node-2
thresh cluster add-node eu-central thresh-node-5

By Team​

thresh cluster create backend-team --description "Backend engineering"
thresh cluster create ml-team --description "Machine learning training nodes"

thresh cluster add-node ml-team gpu-node-1
thresh cluster add-node ml-team gpu-node-2

By Environment​

thresh cluster create production --description "Prod fleet"
thresh cluster create staging --description "Staging / QA"
thresh cluster create development --description "Dev workstations"

Quick Start​

# 1. Authenticate
thresh auth login --hub https://your-hub:7200

# 2. Create a cluster
thresh cluster create production --description "Production nodes"

# 3. Add nodes
thresh cluster add-node production thresh-node-1
thresh cluster add-node production thresh-node-2

# 4. View the cluster
thresh cluster info production

See Also​