Installation

Install the Riven CLI and configure shell completions.

Install

The recommended way to install the Riven CLI is via the install script:

curl -fsSL https://www.riven-ai.dev/install.sh | bash

This downloads a self-contained binary for your platform, verifies its SHA-256 against the release manifest, and installs it under ~/.riven. It needs no Node.js and never uses sudo.

To install a specific version, pass it to the script:

bash

curl -fsSL https://www.riven-ai.dev/install.sh | bash -s -- 0.6.6

npm

If you would rather use npm, and already have Node.js 22 or newer:

bash

npm install -g @riven-ai/cli

Verify Installation

bash

riven --version

Shell Completions

Enable tab completion for all commands and options:

bash

# Auto-detect your shell
eval "$(riven completions)"
 
# Or specify explicitly
eval "$(riven completions bash)"   # Add to ~/.bashrc
eval "$(riven completions zsh)"    # Add to ~/.zshrc
riven completions fish | source    # Add to ~/.config/fish/config.fish

Add the eval line to your shell profile so completions persist across sessions.

Upgrading

bash

riven update

This follows however you installed the CLI: a binary install replaces itself after verifying the new checksum, and an npm install goes through npm. Re-running the install script also works.

Uninstalling

If you used the install script, remove the directory it created and the PATH line it added to your shell profile:

bash

rm -rf ~/.riven

If you installed from npm:

bash

npm uninstall -g @riven-ai/cli

Requirements

The CLI requires the following tools for full functionality:

Tool	Minimum Version	Required For
Node.js	22+	Core CLI runtime
Yarn	4+	Workspace detection, monorepo support
buf	Latest	Proto linting, codegen
git	Any	Version detection, module publishing
Docker	Any	Image building and publishing

Run riven doctor to verify all prerequisites are installed and configured correctly.

PreviousCLI Overview NextAuth