alethia CLI
Go command-line tool for managing multi-cloud infrastructure via the Alethia platform.
alethia CLI
alethia is the command-line interface for the platform. It provides terminal-based access to all infrastructure operations — creating zones, planning and deploying Specs, monitoring jobs, and managing Runners.
Overview
| Property | Value |
|---|---|
| Language | Go |
| Framework | Cobra (commands) + Charmbracelet (TUI) |
| Version | Managed by release-please (alethia-v* tags) |
| Distribution | Homebrew tap + GitHub Releases (darwin/linux, amd64/arm64) |
How It Works
alethia is a thin client that communicates with the Alethia API over HTTPS. It does not run Terraform directly — instead, it queues jobs that Runners execute. The CLI handles:
- Authentication — Device code flow with tokens stored locally
- Configuration — Creating and inspecting zones and Specs
- Job submission — Queuing Plan / Deploy / Destroy jobs
- Monitoring — Streaming logs, checking job status, waiting for completion
- Management — Listing clusters, managing Runners
Command Groups
Zone Commands
Create, list, and delete workspaces.
Spec Commands
List and inspect infrastructure configurations.
Plan & Apply
Queue plan, deploy, and destroy jobs.
Job Commands
List, stream logs, cancel, and wait for jobs.
Worker Commands
Register, list, and remove Runners.
Cluster Commands
List provisioned Kubernetes clusters.
Quick Start
# Install
brew install bobikenobi12/bb-thesis-2026/alethia
# Authenticate
alethia login
# List zones
alethia zone list
# Plan infrastructure
alethia plan --spec-id <id>
# Stream logs
alethia jobs logs --id <job-id> --follow
# Deploy
alethia apply --spec-id <id> --plan-job-id <plan-job-id>