Reference
Command reference
Every verentis command group and subcommand at a glance.
Run verentis --help, or verentis <group> --help, for the authoritative, version-specific listing.
This page groups the commands by area.
Auth & context
| Command | Purpose |
|---|---|
login | Sign in (--api-url, --api-key, --token, --sealing-key) |
logout | Clear the stored credential |
whoami | Show identity, account, and publisher |
use workspace <id> | Set the default workspace |
use account <id> | Set the default account |
context | Show the current default context |
Administration
| Command | Purpose |
|---|---|
account get / update | Read or update the account |
account invite list / create / resend / revoke / accept | Account invitations |
workspace list / get / create / update | Manage workspaces |
workspace domain list / add / remove | Workspace custom domains |
workspace invite list / create / resend / revoke / accept | Workspace invitations |
user list / get / activate / suspend / roles | Manage users |
user grants list / add | Direct permission grants |
apikey create / list / get / update / revoke / regenerate | API keys |
apikey grant add / remove | Grants on a key |
settings list / get / set / delete | Account/workspace settings |
api <method> <path> | Call any endpoint (raw escape hatch) |
Files & executions
| Command | Purpose |
|---|---|
files ls / stat / cat | Browse and read files |
files upload / download | Transfer files (--extract, --format) |
files mv / rm | Move and delete (--recursive) |
exec run / list / get / logs / cancel | Run and inspect executions (--follow) |
engine list / get / resolve / sync | Inspect engines |
Developer loop
| Command | Purpose |
|---|---|
dev run <script> | Run a script locally against a workspace (--debug) |
dev token | Mint a scoped token |
dev context | Generate .verentis/context.json |
dev vscode | Scaffold .vscode/launch.json |
validate [pathOrDir] | Validate a manifest |
Publishing
| Command | Purpose |
|---|---|
publisher create | Create a publisher profile |
keygen | Generate + register an Ed25519 signing key |
key register / revoke | Manage signing keys |
init [dir] | Scaffold a package project |
pack [dir] | Build a signed .vpkg (--encrypt) |
pack verify / seal-keygen | Verify a package / make a sealing key |
publish <vpkg> | Publish to the marketplace |
yank <ref> <version> | Pull a version |
download <ref> [version] | Download a package archive |
search [text] | Search the catalog (--kind) |
install <ref> [version] | Install into a workspace |
uninstall <installationId> | Uninstall from a workspace |
package list / info / versions / update | Manage package metadata |
package deprecate / undeprecate / archive / stats | Package lifecycle |
package visibility set / grant / grants / revoke | Private visibility |
package installs | Installations in a workspace |