Skip to content
Documentation
CLI

Thalassa Cloud CLI (tcloud)

The Thalassa Cloud CLI (tcloud) is a command-line interface for managing your Thalassa Cloud resources. It provides a powerful and intuitive way to interact with the Thalassa Cloud Platform from your terminal.

Quick Start

Installation

macOS (using Homebrew) 

brew install thalassa-cloud/tap/tcloud

Manual Installation

Download the latest release for your platform from the GitHub releases page.

Authentication

Create a context and sign in through your browser (default):

tcloud context create --name default

tcloud opens your browser for OIDC login and stores credentials in your OS keychain. For non-interactive use (CI/CD), pass --token=<PAT> or OIDC client credentials instead. See Authentication for details.

See also

Installation
Authentication
Context Management

Basic Usage 

# Get help
tcloud -h

# Check version
tcloud version

# Get information about the current user
tcloud me

# Generate shell completion
tcloud completion bash  # or zsh, fish, powershell

Global Flags

  • --api string: API endpoint (overrides context)
  • --client-id string: OIDC client ID for OIDC authentication (overrides context)
  • --client-secret string: OIDC client secret for OIDC authentication (overrides context)
  • -c, --context string: Context name
  • -O, --organisation string: Organisation slug or identity (overrides context)
  • --token string: Personal access token (overrides context)

Development

For development information, see the GitHub repository.

References

You can find detailed command references in the CLI Reference documentation.