cli

README

Thalassa Cloud CLI (tcloud)

A command-line interface for managing your Thalassa Cloud Installation.

This project is still in beta. Commands and UX may change while the project is in initial development.

Installation

macOS (using Homebrew)

brew install thalassa-cloud/tap/tcloud

Manual Installation

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

Quick Start

Authenticate with Thalassa Cloud:

tcloud context create --api=https://api.thalassa.cloud --token=<PAT>

Configuration file

With personal access token

configVersion: v1
contexts:
    - name: default
      context:
        api: api.thalassa.cloud
        user: default
        organisation: <ORG_SLUG_OR_IDENTITY>
current-context: default
servers:
    - name: api.thalassa.cloud
      api:
        server: https://api.thalassa.cloud
users:
    - name: default
      user:
        token: <PAT>

Development

Prerequisites

• Go 1.24 or later
• Make

Building from Source

# Clone the repository
git clone https://github.com/thalassa-cloud/cli.git
cd cli

# Build the binary
make build

# Run tests
make test

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.