vcf-super-cli 0.5.0

Modern, agent-friendly CLI for VMware Cloud Foundation 9, with a command tree generated dynamically from the vcf-sdk vAPI bindings.

vcf-super-cli (vsc)

A modern, agent-friendly CLI for VMware Cloud Foundation 9. The command tree is generated dynamically by introspecting the official vcf-sdk vAPI bindings — so the surface mirrors the real VCF 9 API instead of being hand-maintained.

$ vsc vsphere vm list --profile prod
$ vsc vsphere host get --host host-42
$ vsc nsx segments list --output table
$ vsc vsphere power stop vm-42 --apply        # writes are dry-run without --apply

⚠️ Alpha / pre-release. Reads (vSphere + NSX inventory) and writes are both available. Writes are dry-run by default — nothing changes without --apply, and a dry-run never opens a connection.

Why

• Mirrors the real API. Commands come from the SDK's own vAPI metadata (VapiInterface services + OperationRestMetadata), covering both vCenter and NSX from one generator.
• Modern. REST-first via vmware-vcenter, with pyVmomi as a fallback where REST lacks coverage.
• Safe by default. Writes preview as dry-runs unless you pass --apply; a dry-run never opens a connection.
• Agent-friendly. Deterministic command shape, machine-readable JSON output, a stable error envelope with documented exit codes, and a bundled agent Skill.

Scope

Area	Status
vSphere / vCenter read (vsc vsphere …)	✅ v0.1
NSX Policy API read (vsc nsx …)	✅ v0.1
Writes — dry-run by default + --apply (vsc vsphere … / vsc nsx …)	✅ v0.2
Ergonomics — offline shell completion, per-field filter flags + paging, pyVmomi fallback (perf/events/tasks/inventory)	✅ v0.3
Live resource-id completion	✅ v0.4
Find VMs by attribute — IP / hostname / MAC / guest OS / power (vsc vsphere inventory find)	✅ v0.5
NSX Manager / Global-Manager, SDDC Manager, Operations, LCM	deferred

Install

uv tool install vcf-super-cli      # recommended
# or
pipx install vcf-super-cli
# or
pip install vcf-super-cli

From source:

uv sync && uv run vsc --help

Documentation

Full guide: thomaschristory.github.io/vcf-super-cli

License

Apache-2.0. See LICENSE.