@revoengine/cli is the official command-line client for RevoEngine. It requires Node.js 24 or newer.
The package installs revo as the primary command. revoengine remains a compatible alias.
Sign in
Login prompts for an API key, validates it through /api/v1/me, and infers the instance bound to the key. Remove the stored default login with:
Interactive credentials live in the operating-system config directory:
- macOS and Linux:
~/.config/revoengine
- Windows:
%APPDATA%/revoengine
Named environment profiles are stored separately from the default login. Logout does not delete those profiles.
Essential commands
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
--url and --token;
- environment variables;
- stored interactive configuration;
- the default API origin.
Named --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.
Pass CI credentials from the CI secret store. Do not commit tokens in shell scripts, .env files, project metadata, or .revoengine/.
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.
