CLI reference
The veyra CLI is the fastest way to drive runs from your terminal.
Installation
bash
# macOS / Linux
curl -fsSL https://veyra.tubox.cloud/install.sh | sh
# Windows (PowerShell)
iwr https://veyra.tubox.cloud/install.ps1 -useb | iex
# npm
npm i -g @veyra/cliCommands
| Command | Description |
|---|---|
veyra login | Authenticate this machine with a workspace. |
veyra run "<goal>" | Trigger a new run in the current repo. |
veyra status | Show active and recent runs. |
veyra cancel <id> | Cancel a running task. |
veyra trace <id> | Stream the trace for a run. |
veyra keys ls | List API keys for the workspace. |
veyra config set model gpt-5 | Pin a default model. |
Common flags
| Flag | Effect |
|---|---|
--model <id> | Override the routing policy for this run. |
--branch <name> | Use a different base branch. |
--policy strict | Disable network and limit shell tools. |
--watch | Stream the trace as the run executes. |
Example
bash
veyra run "Migrate auth from sessions to JWT" \
--model gpt-5 \
--policy strict \
--watchThe CLI exits with code 0 on success, 1 on failure, 2 on cancellation.