CLI
valvet command-line reference
The valvet CLI talks to the hub’s REST API from your terminal. It shares the same auth endpoints as the web UI and stores credentials locally.
Global flags
| Flag | Description |
|---|---|
--json | Emit the raw API response instead of a formatted table. Works on any subcommand. |
--help | Show help for a command. |
--version | Print the CLI version. |
Auth
| Command | Description |
|---|---|
valvet login [--hub <url>] | Interactive login. Prompts for username and password. Stores credentials (hub URL, access token, refresh token). --hub is optional after the first login. |
valvet logout | Delete stored credentials. |
Nodes
| Command | Description |
|---|---|
valvet nodes ls | Table: NAME OS STATUS LAST SEEN. online is green, offline is red. |
valvet nodes rm <id-or-name> [-y|--yes] | Delete an enrolled node. Resolves by name or UUID. Prompts for confirmation unless -y is passed. |
Repositories
| Command | Description |
|---|---|
valvet repos ls | Table: NAME TYPE CONNECTION TESTED. Connection status is ok, fail, or untested. |
Plans
| Command | Description |
|---|---|
valvet plans ls | Table: NAME NODE REPO SCHEDULE ENABLED. |
Jobs
| Command | Description |
|---|---|
valvet jobs ls [--node <n>] [--plan <p>] [--status <s>] [--limit <n>] | Table: STATUS STARTED PLAN NODE BYTES DURATION. running is cyan (with %), completed green, failed red, cancelled yellow. --node and --plan accept name or UUID. --limit defaults to 20. |
Snapshots
| Command | Description |
|---|---|
valvet snapshots ls <repo> | Table: ID TIME HOSTNAME PATHS TAGS. <repo> accepts name or UUID. |