rackmind-cli

rackmind.ai — AI-powered infrastructure management for MSPs and homelabbers.

A Claude Code-style terminal experience for managing Proxmox servers, LXC containers, and QEMU VMs through natural language.

Installation

npm install -g rackmind-cli

Or link locally for development:

git clone https://github.com/rackmind-ai/rackmind-cli.git
cd rackmind-cli
npm install
npm run build
npm link

Quick Start

# Add your first server
rackmind connect my-proxmox

# Set your Anthropic API key
rackmind config set-api-key

# Launch interactive REPL
rackmind

# Or ask a one-shot question
rackmind "what containers are running?"

Usage

Interactive Mode (REPL)

Launch with no arguments to enter the full interactive terminal:

rackmind

Features:

• Natural language queries about your infrastructure
• AI-powered command execution with tool use
• Streaming responses with markdown rendering
• Slash commands: /help, /clear, /status, /servers, /model, /exit, /quit, /q
• Keyboard shortcuts: Up/Down for history, Ctrl+C to exit

One-shot Mode

Ask a single question and get a streamed response:

rackmind "check disk usage on all containers"
rackmind ask "restart container 106"

Fully pipeable:

rackmind "list running containers" --json | jq '.response'
rackmind "what is the uptime?" --quiet 2>/dev/null

Subcommands

Server Management

rackmind connect <alias>          # Connect to (or create) a server profile
rackmind servers list              # List all server profiles
rackmind servers add <alias>       # Add a new server profile
rackmind servers remove <alias>    # Remove a server profile
rackmind servers switch <alias>    # Switch the active server

Infrastructure Status

rackmind status                    # Show config, connection status, server list
rackmind containers                # List all LXC containers
rackmind vms                       # List all QEMU virtual machines
rackmind report                    # Generate a full health report

Guest Lifecycle

rackmind start <vmid>              # Start a container or VM
rackmind stop <vmid>               # Stop a container or VM (with confirmation)
rackmind restart <vmid>            # Restart a container or VM (with confirmation)
rackmind stop <vmid> --force       # Skip confirmation prompt

Command Execution

rackmind exec "uptime"                     # Run on the Proxmox host
rackmind exec "apt update" --target=106    # Run inside LXC container 106

Logs

rackmind logs <vmid>               # Tail logs for a container or VM
rackmind logs <vmid> -n 100        # Show last 100 lines
rackmind logs <vmid> -f            # Follow log output

Configuration

rackmind config                    # Show current configuration
rackmind config set <key> <value>  # Set a preference
rackmind config reset              # Reset preferences to defaults
rackmind config set-api-key        # Set or update the Anthropic API key
rackmind config path               # Print the config file path

Available preference keys:

• model -- AI model (default: claude-sonnet-4-5)
• theme -- Color theme: dark or light
• confirmDestructive -- Require confirmation for destructive actions (true/false)
• timestampMessages -- Show timestamps on messages (true/false)

Account & Billing

rackmind login                    # Authenticate with your RackMind account
rackmind logout                   # Clear stored auth token
rackmind account                  # Show current plan, usage, and account info

Global Flags

These flags work with any command:

| Flag | Description | | ------------------- | --------------------------------------------------------- | | --json | Output in JSON format (implies --quiet) | | --quiet | Suppress spinners, banners, and non-essential output | | --no-color | Disable colored output (also respects NO_COLOR env var) | | --server <url> | Override the RackMind server URL | | -i, --interactive | Force interactive REPL mode |

Configuration

Config is stored at ~/.config/rackmind/config.json (XDG-compliant).

Credentials (API keys, passwords, token secrets) are encrypted using Node.js crypto with a machine-derived key. They are never stored in plaintext.

Config writes are atomic (write to temp file, then rename) to prevent corruption.

Subscription & Billing

RackMind CLI uses your RackMind account for billing and subscription management. All billing is handled through the website at rackmind.ai.

Authentication

Authenticate the CLI with your RackMind account:

rackmind login

This opens your browser to sign in. Once authenticated, the CLI stores a local auth token (encrypted) so you stay logged in across sessions.

To log out:

rackmind logout

Free vs Pro

| Feature | Free | Pro ($15/mo) | | -------------------------- | --------------- | ---------------- | | Server connections | 1 | Unlimited | | Managed AI interactions/mo | 25 | 200 | | Bring Your Own Key (BYOK) | -- | Unlimited | | Solution memory | -- | Included | | Historical metrics | 1 hour | Unlimited | | Terminal AI | -- | Included |

Free tier -- great for trying RackMind on a single server with basic AI assistance.

Pro tier -- unlocks unlimited servers, BYOK (use your own API keys for unlimited AI), solution memory that learns from past fixes, and full historical metrics.

Manage Your Subscription

All subscription management (upgrade, downgrade, payment method, invoices) happens at:

https://rackmind.ai/account

Or view your current plan from the CLI:

rackmind account

Requirements

• Node.js 20+
• A Proxmox VE server with API token access
• An Anthropic API key (for AI features) or a RackMind Pro subscription for managed AI

Development

npm run dev            # Run in dev mode (tsx)
npm run build          # Compile TypeScript
npm run lint           # Run ESLint
npm run format         # Format with Prettier
npm run type-check     # Type-check with tsc

All three quality gates must pass before every commit:

tsc --noEmit
npx eslint .
npx prettier --check .

License

All rights reserved.