# spirlctl cli utility

defakto-cli is now available

`defakto` is the new Defakto-branded CLI, built from the same codebase as `spirlctl`. See [installing defakto-cli](/releases/defakto-cli.md) and [migrating from spirlctl](/cli/spirlctl/migrate-to-defakto.md).

`spirlctl` (pronounced like *spai·ruhl cuddle*) is a command line utility (CLI) to interact and manage Defakto cloud, and Defakto components installed in the customer's environment.

## Getting Started[​](#getting-started "Direct link to Getting Started")

1. **[Install spirlctl](/mint/quick-start/download-spirlctl.md)** - Download and install the CLI
2. **[Invite users](/cli/spirlctl/invite-users.md)** - Invite other colleagues to the Defakto Cloud.
3. **[Login](/cli/spirlctl/login-logout.md)** - Authenticate with Defakto
4. **[Create a Trust Domain](/cli/spirlctl/trust-domain-operations.md)** - Set up your first trust domain
5. **[Add a Cluster](/cli/spirlctl/cluster-management.md)** - Connect your Kubernetes cluster

## Common Tasks[​](#common-tasks "Direct link to Common Tasks")

### Authentication[​](#authentication "Direct link to Authentication")

```
# Log in to Defakto (using Google)

spirlctl login



# Log in to a specific organization (e.g. enterprise SSO,

# or when using multiple organizations)

spirlctl login --org my-org



# Check your identity

spirlctl whoami



# Log out

spirlctl logout
```

See [Login & Logout guide](/cli/spirlctl/login-logout.md) for more details.

### Trust Domains[​](#trust-domains "Direct link to Trust Domains")

```
# Create a trust domain

spirlctl trust-domain create example.com



# List all trust domains

spirlctl trust-domain list



# Get trust domain information

spirlctl trust-domain info example.com
```

See [Trust Domain Operations guide](/cli/spirlctl/trust-domain-operations.md) for more details.

### Clusters[​](#clusters "Direct link to Clusters")

```
# Add a Kubernetes cluster

spirlctl cluster add production --trust-domain example.com --platform k8s



# List all clusters

spirlctl cluster list



# Get cluster information

spirlctl cluster info production --trust-domain example.com



# List cluster configurations

spirlctl cluster config list production --trust-domain example.com
```

See [Cluster Management guide](/cli/spirlctl/cluster-management.md) for more details.

## In more detail[​](#in-more-detail "Direct link to In more detail")

For detailed documentation on using spirlctl, see:

* **[Login & Logout](/cli/spirlctl/login-logout.md)** - Authentication workflows and session management
* **[Trust Domain Operations](/cli/spirlctl/trust-domain-operations.md)** - Creating and managing SPIFFE trust domains
* **[Cluster Management](/cli/spirlctl/cluster-management.md)** - Managing Kubernetes clusters and configurations

## Help at the command line[​](#help-at-the-command-line "Direct link to Help at the command line")

`spirlctl` comes with built-in help:

```
$ spirlctl help
```

### Command-specific help[​](#command-specific-help "Direct link to Command-specific help")

For detailed help on any command, use the `--help` flag:

```
spirlctl --help

spirlctl [command] --help

spirlctl [command] [subcommand] --help
```

Example:

```
$ spirlctl cluster --help



Commands for working with clusters



Usage:

  spirlctl cluster [command]



Available Commands:

  add         Adds NAME cluster to the SPIFFE trust domain TD_NAME

  config      Commands for working with cluster configs

  delete      Deletes a cluster from a trust domain

  disable     Disable a cluster

  info        Gets detailed information about a cluster

  list        Lists all clusters

  register    Register CLUSTER_NAME cluster to the SPIFFE trust domain TD_NAME
```