bnerd CLI¶

The bnerd command-line client is the primary way to manage b'nerd cloud infrastructure from the terminal. It covers the full platform surface: DNS, domains, Kubernetes, compute (servers, volumes, networks, routers), load balancers, object storage (RGW), billing, and WireGuard VPN. Beyond a traditional CLI it ships an interactive TUI, an MCP server for AI clients, and a built-in AI assistant.

Full command reference and guides: cli.docs.bnerd.com

What it manages¶

Area	Commands
DNS	`bnerd dns zones` · `bnerd dns records`
Domains	`bnerd domains`
Kubernetes	`bnerd k8s`
Compute	`bnerd servers` · `bnerd volumes` · `bnerd networks` · `bnerd routers`
Load balancers	`bnerd loadbalancers`
Object storage	`bnerd rgw users` · `bnerd rgw buckets`
Billing	`bnerd billing`
VPN	`bnerd vpn`
Organization	`bnerd members` · `bnerd invitations` · `bnerd accounts`

All commands support -o table (default), -o json, and -o yaml for scripting.

Install¶

Pre-built binaries for Linux, macOS, and Windows (amd64 / arm64) are published to the GitLab Package Registry with every tagged release.

If you have Go 1.24+:

go install git.bnerd.net/cloud/app/cli@latest

Full installation options (binary download, checksum verification, CycloneDX SBOM): cli.docs.bnerd.com/getting-started/installation

Quick start¶

1. Authenticate¶

bnerd login

The interactive prompt asks for your API URL, credentials, and organization — it writes ~/.bnerd.yaml (mode 0600). For non-interactive or CI use, configure manually:

bnerd config set api-url https://api.bnerd.cloud
bnerd config set token   YOUR_API_TOKEN
bnerd config set org-id  YOUR_ORG_ID

2. Verify¶

bnerd whoami

3. First commands¶

bnerd dns zones list          # list DNS zones
bnerd k8s clusters list       # list Kubernetes clusters
bnerd servers list            # list compute servers
bnerd billing overview        # billing summary
bnerd x                       # launch the interactive TUI

Modes¶

Interactive TUI — bnerd x opens a Bubbletea terminal UI with :command navigation across all resource types. TUI documentation →

MCP server — bnerd mcp-server exposes 100+ cloud-management tools to Claude Desktop and other MCP clients, with three-tier safety modes (read-only / non-destructive / full). MCP documentation →

AI assistant — bnerd pa provides an AI assistant backed by Anthropic or OpenAI-compatible models. The --isolate flag runs AI-generated commands inside bubblewrap, podman, or docker for filesystem isolation. AI isolation guide →

Configuration¶

Default config: ~/.bnerd.yaml (mode 0600). Precedence: CLI flags → BNERD_* environment variables → config file → defaults.