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
(
VapiInterfaceservices +OperationRestMetadata), covering both vCenter and NSX from one generator. - Modern. REST-first via
vmware-vcenter, withpyVmomias 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 Traceflow — inject a synthetic packet, read its path (vsc nsx traceflows / vsc nsx observations) |
✅ v0.6 |
| 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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vcf_super_cli-0.6.0.tar.gz.
File metadata
- Download URL: vcf_super_cli-0.6.0.tar.gz
- Upload date:
- Size: 176.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9405521915fec97746d461214f4bbe9769b8c4eeb82e3cc8b08192f78fe3a8e
|
|
| MD5 |
145a2cedbf1c24b94d8689b56925a601
|
|
| BLAKE2b-256 |
c856fd1379058fb84247dc1bcef98bea39e763a08bd4f7d9efdfb29058d31a58
|
Provenance
The following attestation bundles were made for vcf_super_cli-0.6.0.tar.gz:
Publisher:
release.yml on thomaschristory/vcf-super-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vcf_super_cli-0.6.0.tar.gz -
Subject digest:
d9405521915fec97746d461214f4bbe9769b8c4eeb82e3cc8b08192f78fe3a8e - Sigstore transparency entry: 2064093889
- Sigstore integration time:
-
Permalink:
thomaschristory/vcf-super-cli@6b8ac0286dbd43137dcd1b71251e409e30c62546 -
Branch / Tag:
refs/tags/v0.6.0 - Owner: https://github.com/thomaschristory
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6b8ac0286dbd43137dcd1b71251e409e30c62546 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vcf_super_cli-0.6.0-py3-none-any.whl.
File metadata
- Download URL: vcf_super_cli-0.6.0-py3-none-any.whl
- Upload date:
- Size: 63.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b65609ebdca8496fe700a6dfc9dd5f78e5cf1f5069889ffbe7f8ffbefc34729c
|
|
| MD5 |
c2e9014767bf66e1b34b7a6e45ffe7f3
|
|
| BLAKE2b-256 |
887485faa2308bce310f832272b8020e520e20e2f74003f64411b28675353f16
|
Provenance
The following attestation bundles were made for vcf_super_cli-0.6.0-py3-none-any.whl:
Publisher:
release.yml on thomaschristory/vcf-super-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vcf_super_cli-0.6.0-py3-none-any.whl -
Subject digest:
b65609ebdca8496fe700a6dfc9dd5f78e5cf1f5069889ffbe7f8ffbefc34729c - Sigstore transparency entry: 2064093901
- Sigstore integration time:
-
Permalink:
thomaschristory/vcf-super-cli@6b8ac0286dbd43137dcd1b71251e409e30c62546 -
Branch / Tag:
refs/tags/v0.6.0 - Owner: https://github.com/thomaschristory
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6b8ac0286dbd43137dcd1b71251e409e30c62546 -
Trigger Event:
push
-
Statement type:
