ReferenceCLI
Version: 0.1.7
The workspace comes from --workspace, NEVIA_WORKSPACE, the nearest .nevia.toml, then your config. nevia config shows each value and where it came from.
Exit codes, one per class of failure (--json errors carry the same number as error.exit_code):
- 0 success
- 1 error: an operation failed or the response was unexpected
- 2 unauthorized: sign in again with
nevia login - 3 not found: no resource by that name in the workspace
- 4 forbidden: your role does not allow it
- 5 conflict: check the resource's state, then retry
- 6 retryable: the service was busy or unreachable, or --timeout ran out
- 7 invalid request: fix the flags or arguments
- 8 state: no credential or configuration, before any request
nevia exec exits with the remote command's status instead.
nevia [FLAGS] <SUBCOMMAND>
Global options
--workspace <WS>- Workspace ID or exact name--json- Print JSON on supported commands--non-interactive- Never prompt, launch a browser, or open an interactive session-y, --yes- Skip confirmations and install updates without asking
Options
-h, --help- Print help-V, --version- Print version
Subcommands
nevia login [--no-browser]nevia logoutnevia whoaminevia confignevia workspace <SUBCOMMAND>nevia workspace create [--use] [--idempotency-key <KEY>] [NAME]nevia workspace lsnevia workspace get [WS]nevia workspace rm [--wait] [--timeout <DURATION>] [WS]nevia workspace use [--local] [--unset] [WS]nevia workspace currentnevia access <SUBCOMMAND>nevia access ls [WS]nevia access add [FLAGS] [WHO]nevia access get <WHO>nevia access set [FLAGS] <WHO>nevia access rm <WHO>nevia access keys <SUBCOMMAND>nevia access keys rotate [FLAGS] <WHO>nevia access keys rm <WHO>nevia access invites <SUBCOMMAND>nevia access invites ls [--state <STATE>] [--limit <LIMIT>] [WS]nevia access invites rm [WS] <INV>nevia new [FLAGS] [NAME]nevia ls [-f --filter <KEY=VALUE>]nevia status [COMPUTER]nevia set [FLAGS] [COMPUTER]nevia rm [--wait] [--timeout <DURATION>] [COMPUTER]nevia suspend [--wait] [--timeout <DURATION>] [COMPUTER]nevia awake [--wait] [--timeout <DURATION>] [COMPUTER]nevia branch [FLAGS] [NAME]nevia imagesnevia exec [FLAGS] [COMPUTER] [-- CMD]…nevia checkpoint <SUBCOMMAND>nevia checkpoint create [FLAGS]nevia checkpoint ls [-c --computer <COMPUTER>] [--state <STATE>]nevia checkpoint status [-c --computer <COMPUTER>] <CHECKPOINT>nevia checkpoint rm [FLAGS] <CHECKPOINT>nevia restore [FLAGS] <CHECKPOINT>nevia ops [-f --filter <KEY=VALUE>] [-n --limit <N>]nevia wait [--timeout <DURATION>] <OPERATION>nevia pg <SUBCOMMAND>nevia pg create [FLAGS] [NAME]nevia pg ls [-f --filter <KEY=VALUE>]nevia pg status [DATABASE]nevia pg set [--name <NAME>] [--protected <BOOL>] [DATABASE]nevia pg rm [--wait] [--timeout <DURATION>] [DATABASE]nevia pg branch [FLAGS] [DATABASE]nevia pg connect [FLAGS] [DATABASE]nevia pg reset-password [DATABASE]nevia pg suspend [--wait] [--timeout <DURATION>] [DATABASE]nevia pg awake [--wait] [--timeout <DURATION>] [DATABASE]nevia secrets [--file <PATH>] [NAME] [SUBCOMMAND]nevia secrets lsnevia secrets unset <NAME>…nevia variables [--value <TEXT>] [--file <PATH>] [NAME] [SUBCOMMAND]nevia variables lsnevia variables unset <NAME>…nevia variables .env <-f --file <PATH>>nevia update [--dry-run] [VERSION]nevia auth <SUBCOMMAND>nevia auth access-tokennevia auth use-key-file [--local] [--unset] [FILE]