Doctor, Init, and Completions
Environment diagnostics, workspace initialization, and shell completions.
riven doctor
Check that all prerequisites are installed and the environment is correctly configured. This validates Node.js version, Yarn, buf, git, Docker availability, registry connectivity, and stored credentials.
riven doctorChecks Performed
| Check | Requirement |
|---|---|
| Node.js | Version 22 or higher |
| Yarn | Version 4+ (Berry) |
| buf | Installed and on PATH |
| git | Installed and on PATH |
| Docker | Daemon running |
| Registry | Connectivity to configured proto registry |
| Credentials | Valid stored auth token |
If any check fails, the CLI prints a remediation hint.
riven init
Initialize a Riven workspace configuration file (.rivenrc.json) in the current directory. This stores default values for --registry-url and --org-id so you don't have to pass them on every command.
riven init --registry-url https://proto.riven-ai.dev --org-id my-org| Option | Description |
|---|---|
--registry-url <url> | Proto registry URL to store |
--org-id <id> | Organization ID to store |
The generated .rivenrc.json is read automatically by all CLI commands.
riven completions
Generate shell completions for bash, zsh, or fish. The shell type is auto-detected from $SHELL by default.
# Auto-detect shell
riven completions
# Explicit shell
riven completions bash
riven completions zsh
riven completions fishPersistent Setup
Add the completion command to your shell profile:
# Bash — add to ~/.bashrc
eval "$(riven completions bash)"
# Zsh — add to ~/.zshrc
eval "$(riven completions zsh)"
# Fish — add to ~/.config/fish/config.fish
riven completions fish | source