Skip to content
verda-cloudPublic

About

No description, website, or topics provided.

Resources

Stars

16 stars

Watchers

1 watching

Forks

Repository files navigation

Verda CLI

Command-line interface for Verda Cloud — manage VMs, volumes, SSH keys, startup scripts, and more from your terminal.

verda vm create

Both interactive and non-interactive modes — use the wizard for quick tasks, flags for scripts and automation.

Install

Quick install (macOS / Linux)

curl -sSL https://raw.githubusercontent.com/verda-cloud/verda-cli/main/scripts/install.sh | sh

Install to a custom directory:

VERDA_INSTALL_DIR=~/.local/bin curl -sSL https://raw.githubusercontent.com/verda-cloud/verda-cli/main/scripts/install.sh | sh

Homebrew (macOS / Linux)

brew install verda-cloud/tap/verda-cli

Scoop (Windows)

scoop bucket add verda https://github.com/verda-cloud/homebrew-tap
scoop install verda-cli

Linux packages (deb / rpm / apk)

Download .deb, .rpm, or .apk packages from GitHub Releases:

# Debian / Ubuntu
sudo dpkg -i verda_VERSION_linux_amd64.deb

# RHEL / Fedora
sudo rpm -i verda_VERSION_linux_amd64.rpm

# Alpine
sudo apk add --allow-untrusted verda_VERSION_linux_amd64.apk

Manual download

Download the binary for your platform from GitHub Releases:

Platform File
macOS (Apple Silicon) verda_VERSION_darwin_arm64.tar.gz
macOS (Intel) verda_VERSION_darwin_amd64.tar.gz
Linux (x86_64) verda_VERSION_linux_amd64.tar.gz
Linux (ARM64) verda_VERSION_linux_arm64.tar.gz
Windows (x86_64) verda_VERSION_windows_amd64.zip
Windows (ARM64) verda_VERSION_windows_arm64.zip
tar xzf verda_*.tar.gz
sudo mv verda /usr/local/bin/

Go install

go install github.com/verda-cloud/verda-cli/cmd/verda@latest

Verify & update

verda --version          # verify installation
verda update             # update to latest
verda update --target v1.0.0   # specific version

Getting Started

1. Configure credentials

verda auth login

2. Explore available resources

verda locations                        # datacenter locations
verda instance-types --gpu             # GPU instance types with pricing
verda availability --location FIN-01   # what's in stock

3. Deploy a VM

# Interactive wizard
verda vm create

# Non-interactive
verda vm create \
  --kind gpu \
  --instance-type 1V100.6V \
  --location FIN-01 \
  --os ubuntu-24.04-cuda-13.0-open-docker \
  --os-volume-size 100 \
  --hostname gpu-runner

4. Connect

verda ssh gpu-runner

AI Agent Integration (MCP) — Beta

The Verda CLI includes a built-in MCP server that lets AI agents (Claude Code, Cursor, etc.) manage your infrastructure through natural language. This feature is in beta — feedback welcome.

Setup

{
  "mcpServers": {
    "verda": {
      "command": "verda",
      "args": ["mcp", "serve"]
    }
  }
}

Add this to your agent's MCP config:

Agent Config file
Claude Code .mcp.json in project root
Cursor ~/.cursor/mcp.json

Usage

Once configured, just talk to your agent:

"What GPU types are available right now?"
"How much does an 8x H100 cost per hour?"
"I need a cheap GPU for testing — what's the best option?"
"Deploy a V100 GPU VM with 100GB OS volume"
"Show my running VMs and what they're costing me"
"Shut down my training VM"

Credentials are shared with the CLI — run verda auth login first.

Safety contract

Hibernate is deprecated and will be removed in a future version. It discontinues compute and retains volumes. Retained volumes continue billing.

Tools that create billed resources (create_vm, create_volume) require confirm: true, and vm_action requires it for the destructive actions (shutdown, force_shutdown, hibernate (deprecated), delete) — the same gate as --yes in --agent mode. Without it the tool fails with CONFIRMATION_REQUIRED in the agent error format, so the agent can present the exact action to the user and retry after approval.

vm_action reports status: "accepted" once the API accepts the action; only wait: true polls the instance to its expected status and reports "completed" (create_vm waits by default). Argument types are validated strictly — wrong JSON types and unknown enum values fail with VALIDATION_ERROR instead of being silently coerced. The full tool/parameter reference lives in cmd/mcp/README.md.

Agent Mode

For scripts and agents that use the CLI directly (without MCP):

verda --agent vm list                  # JSON output, no prompts
verda --agent vm create ...            # structured errors for missing flags
verda --agent vm action --id X --action shutdown --yes

See Agent Error Format for the structured error specification.

Configuration

Credentials are stored in ~/.verda/credentials (INI format):

[default]
verda_base_url      = https://api.verda.com/v1
verda_client_id     = your-client-id
verda_client_secret = your-client-secret

Multiple profiles are supported — switch with verda auth use PROFILE.

Documentation

Doc Description
Command Reference Full list of commands, flags, and examples (regenerated at each release)
Authentication Credential resolution order and environment variables
Scripting and Agent Mode Structured output, --wait, and --agent mode
Agent Error Format Structured error specification for --agent mode

Contributing

See CLAUDE.md and AGENTS.md for development setup and coding conventions.

License

See LICENSE for details.

About

No description, website, or topics provided.

Resources

Stars

16 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages