@revoengine/cli is the official command-line client for RevoEngine. It requires Node.js 24 or newer.
revo as the primary command. revoengine remains a compatible alias.
Sign in
/api/v1/me, and infers the instance bound to the key. Remove the stored default login with:
- macOS and Linux:
~/.config/revoengine - Windows:
%APPDATA%/revoengine
Essential commands
To connect a computer or virtual machine for an Assistant, follow Connect a terminal. After signing in with a personal API key,revo terminal connect --workspace "$HOME/projects/my-project" --name "Work VM" creates a pending request. Its owner must approve it in Settings → Vault → Terminals from a browser session before the Assistant can use it. Later connections with the same profile and terminal name preserve the device registration; an additional directory becomes a separately approved workspace. Approved online workspaces are available directly to the Assistant. See the terminal guide for connection recovery, background services, browser state and file transfers.
revo request is a low-level escape hatch for authenticated Platform API calls. Prefer dedicated commands when they provide planning, confirmation, local state, or verification.
Configuration precedence
For the default client, configuration resolves in this order:- command flags such as
--urland--token; - environment variables;
- stored interactive configuration;
- the default API origin.
--from and --to environment profiles resolve independently and are not mixed with the default environment variables.
Supported environment aliases include:
REVO_BASE_URL, REVO_API_KEY, and their REVOENGINE_* equivalents are also supported.
Automation output
Commands that support--json emit machine-readable output for CI and review tooling. Human-readable progress and streamed debug logs use stderr where appropriate, leaving the final result on stdout.
The interactive update notifier checks for a newer CLI release at most once every 24 hours. Disable it in CI with REVO_NO_UPDATE_NOTIFIER=1 or --no-update-notifier.