vcf-super-cli¶

A modern, agent-friendly CLI for VMware Cloud Foundation 9 whose command tree is generated dynamically from the official vcf-sdk vAPI bindings.

$ vsc vsphere vm list --power-states POWERED_ON --profile prod
$ vsc nsx segments list --all --output table
$ vsc vsphere perf vm vm-42 --metric cpu.usage

Pre-1.0

Reads and writes are both available. Writes are dry-run by default — nothing changes without --apply. See Writes. While on 0.x, minor versions may include breaking changes.

Highlights¶

Mirrors the real API — commands come from the SDK's vAPI metadata, covering vCenter and NSX from one generator.
Ergonomic — tab-completion (enums, formats, profiles, filter choices, and opt-in live resource ids), per-field --<field> filter flags, and paging (--all / --max-items / --limit).
pyVmomi fallback — read-only perf, events, tasks, and inventory commands for areas the REST/vAPI surface doesn't cover, including inventory find to locate a VM by IP / hostname / MAC / guest OS.
Safe by default — writes are dry-run unless --apply; a dry-run never connects.
Agent-friendly — JSON output, stable error envelope, documented exit codes, bundled agent Skill.

See the Design for how dynamic generation works, and Commands for the full surface.

Install¶

uv tool install vcf-super-cli       # or: pip install vcf-super-cli
vsc --install-completion            # optional: offline shell completion

From source:

uv sync
uv run vsc --help