cloudstack-skill

A Claude Code skill for managing Apache CloudStack infrastructure via the cmk (CloudMonkey) CLI.

Overview

This skill gives Claude Code access to the full CloudStack API through the official cmk command-line tool. It ships pre-built binaries for all major platforms and configures cmk for AI-friendly non-interactive use.

Supported platforms

OS	Architecture	Binary
macOS	Apple Silicon (arm64)	bin/cmk.darwin.arm64
macOS	Intel (x86-64)	bin/cmk.darwin.x86-64
Linux	ARM64	bin/cmk.linux.arm64
Linux	x86-64	bin/cmk.linux.x86-64
Windows	x86-64	bin/cmk.windows.x86-64.exe

The wrapper script bin/cmk (Unix) and bin/cmk.cmd (Windows) auto-detect the current OS and architecture and delegate to the correct binary.

Installation

Via Claude Code plugin system

/plugin install cloudstack-skill

Manual

1. Clone this repository.
2. Add bin/ to your PATH:

   export PATH="/path/to/cloudstack-skill/bin:$PATH"

3. Initialize the config (see below).

Configuration

Run the following once to set up AI-friendly defaults:

cmk set display json        # JSON output for AI parsing
cmk set autocomplete false  # disable interactive completion
cmk set asyncblock true     # wait for async operations
cmk set timeout 1800

# API key authentication (recommended)
cmk set url       http://<host>:8080/client/api
cmk set apikey    <your-api-key>
cmk set secretkey <your-secret-key>

Config is stored at ~/.cmk/config.

Usage

cmk <verb> <noun> [key=value ...]

Examples

cmk list virtualmachines
cmk list virtualmachines state=Running
cmk start virtualmachine id=<uuid>
cmk stop virtualmachine id=<uuid>
cmk destroy virtualmachine id=<uuid>
cmk list zones
cmk list volumes
cmk list networks
cmk list publicipaddresses
cmk list apis                          # discover all available API commands

Multiple environments

cmk set profile production   # switch to a named profile
cmk list profiles            # list all configured profiles

Binary version

CloudMonkey v6.5.0 — apache/cloudstack-cloudmonkey

License

Apache License 2.0