https://github.com/thalassa-cloud/cli
A command-line interface for the Thalassa Cloud Platform
https://github.com/thalassa-cloud/cli
cli cloud command-line golang homebrew kubernetes tcloud thalassa-cloud
Last synced: 6 months ago
JSON representation
A command-line interface for the Thalassa Cloud Platform
- Host: GitHub
- URL: https://github.com/thalassa-cloud/cli
- Owner: thalassa-cloud
- License: apache-2.0
- Created: 2025-03-14T16:33:06.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-21T12:05:25.000Z (6 months ago)
- Last Synced: 2026-01-21T22:58:51.689Z (6 months ago)
- Topics: cli, cloud, command-line, golang, homebrew, kubernetes, tcloud, thalassa-cloud
- Language: Go
- Homepage: https://docs.thalassa.cloud
- Size: 387 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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)
```bash
brew install thalassa-cloud/tap/tcloud
```
### Manual Installation
Download the latest release for your platform from the [GitHub releases page](https://github.com/thalassa-cloud/cli/releases).
## Quick Start
Authenticate with Thalassa Cloud:
```bash
tcloud context create --api=https://api.thalassa.cloud --token=
```
## Configuration file
### With personal access token
```yaml
configVersion: v1
contexts:
- name: default
context:
api: api.thalassa.cloud
user: default
organisation:
current-context: default
servers:
- name: api.thalassa.cloud
api:
server: https://api.thalassa.cloud
users:
- name: default
user:
token:
```
## Development
### Prerequisites
- Go 1.24 or later
- Make
### Building from Source
```bash
# Clone the repository
git clone https://github.com/thalassa-cloud/cli.git
cd cli
# Build the binary
make build
# Run tests
make test
```
### Run E2E tests
> Note: Running E2E tests creates real resources and you may be charged for these!
```bash
# Build the binary first
make build
# Set environment variables
export TCLOUD_E2E_API_ENDPOINT="https://api.thalassa.cloud"
export TCLOUD_E2E_PERSONAL_ACCESS_TOKEN="your-token"
export TCLOUD_E2E_ORGANISATION="org-id"
# Run tests
make test-e2e
# or
go test ./e2e/... -v
```
## Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
## License
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.