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