Skip to content

nirvana-labs/nirvana-cli

Repository files navigation

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

About

Nirvana Labs CLI

Resources

License

Security policy

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •