nirvana-cli

Nirvana Labs CLI

The official CLI for the Nirvana Labs REST API.

Installation

Installing with Homebrew

brew tap nirvana-labs/tap
brew install nirvana

Installing with Go

go install 'github.com/nirvana-labs/nirvana-cli/cmd/nirvana@latest'

Running Locally

./scripts/run args...

Usage

The CLI follows a resource-based command structure:

nirvana [resource] [command] [flags]

nirvana compute:vms create \
  --boot-volume '{size: 100, type: nvme, tags: [production, ethereum]}' \
  --cpu-config '{vcpu: 2}' \
  --memory-config '{size: 2}' \
  --name my-vm \
  --os-image-name ubuntu-noble-2025-10-01 \
  --public-ip-enabled \
  --region us-wdc-1 \
  --ssh-key '{public_key: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDBIASkmwNiLcdlW6927Zjt1Hf7Kw/PpEZ4Zm+wU9wn2}' \
  --subnet-id 123e4567-e89b-12d3-a456-426614174000 \
  --data-volume '{name: my-data-volume, size: 100, type: nvme, tags: [production, ethereum]}' \
  --tag production \
  --tag ethereum

For details about specific commands, use the --help flag.

Global Flags

• --help - Show command line usage
• --debug - Enable debug logging (includes HTTP request/response details)
• --version, -v - Show the CLI version
• --base-url - Use a custom API backend URL
• --format - Change the output format (auto, explore, json, jsonl, pretty, raw, yaml)
• --format-error - Change the output format for errors (auto, explore, json, jsonl, pretty, raw, yaml)
• --transform - Transform the data output using GJSON syntax
• --transform-error - Transform the error output using GJSON syntax