This release is a pre-release and may not be stable for production use.
VGS CLI
Command Line Tool for programmatic configurations on VGS.
Table of Contents
Requirements
Python 3.11 or newer with OpenSSL 1.1.1 or newer, or Docker.
Installation
PyPI
Install from PyPI:
python3 -m pip install vgs-cli
Run
Verify the installation:
vgs --version
Running in Docker
Check our official documentation.
AI agent skill
Install the agent skill:
npx skills add verygoodsecurity/vgs-cli --skill vgs-cli-guide
The guide covers Dashboard-assisted onboarding, the complete built-in command surface, controlled route and Collect Form changes, service-account automation, Docker, certificates, logs, and troubleshooting. Installation uses the Skills CLI.
Update the agent skill:
npx skills update vgs-cli-guide
Commands
Full command reference:
- https://docs.verygoodsecurity.com/vault/developer-tools/vgs-cli/commands
- Routes YAML format (
routes.yaml): https://docs.verygoodsecurity.com/vault/developer-tools/vgs-cli/commands#routes.yaml
Common commands:
List all available commands:
vgs --help
Start an interactive session:
vgs login
End the current session:
vgs logout
List tenant routes:
vgs get routes -T <TENANT_ID>
Apply tenant routes:
vgs apply routes -T <TENANT_ID> -f <FILE>
Delete one tenant route:
vgs delete routes -T <TENANT_ID> <ROUTE_ID>
List Collect Forms:
vgs get forms -T <TENANT_ID>
Get one Collect Form:
vgs get form -T <TENANT_ID> <FORM_ID>
Apply a Collect Form:
vgs apply form -T <TENANT_ID> -f <FILE>
Apply inline Collect Form JSON:
vgs apply form -T <TENANT_ID> --json '<JSON>'
Delete one Collect Form:
vgs delete form -T <TENANT_ID> <FORM_ID>
View tenant access logs:
vgs logs access -T <TENANT_ID>
View request operation logs:
vgs logs operations -T <TENANT_ID> -R <REQUEST_ID>
List tenant access credentials:
vgs get access-credentials -T <TENANT_ID>
Generate tenant access credentials:
vgs generate access-credentials -T <TENANT_ID>
List accessible organizations:
vgs get organizations
Show certificate commands:
vgs certificate --help
Automation with VGS CLI
If you want to use the VGS CLI for automation, create a service account.
5 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
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 vgs_cli-1.33.0.dev2-py3-none-any.whl.
File metadata
- Download URL: vgs_cli-1.33.0.dev2-py3-none-any.whl
- Upload date:
- Size: 66.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5775898b2e71dea26fb9da872c732f3df653707577623375678e80d298f09ab4
|
|
| MD5 |
fd22a7a9ee7c5c599d5fb522ae73de1f
|
|
| BLAKE2b-256 |
be755e273386dba68716bfbbaabc5bc2026ce6e138e35a36c412187cd6c88177
|
Provenance
The following attestation bundles were made for vgs_cli-1.33.0.dev2-py3-none-any.whl:
Publisher:
build-publish.yaml on verygoodsecurity/vgs-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vgs_cli-1.33.0.dev2-py3-none-any.whl -
Subject digest:
5775898b2e71dea26fb9da872c732f3df653707577623375678e80d298f09ab4 - Sigstore transparency entry: 2513851385
- Sigstore integration time:
-
Permalink:
verygoodsecurity/vgs-cli@4c312975d951b0f12b5d1264948a081234874a23 -
Branch / Tag:
refs/tags/1.33.0.dev2 - Owner: https://github.com/verygoodsecurity
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build-publish.yaml@4c312975d951b0f12b5d1264948a081234874a23 -
Trigger Event:
push
-
Statement type:
