Skip to content
RavenstashRavenstashRavenstash

Ravenstash CLI overview

rvs is the Ravenstash command-line tool. It signs you in through your browser, lets you choose a private repository or mirror, and runs familiar package tools with temporary Ravenstash access.

Install rvs

The installers select the native build for the current operating system and processor. A system Python is not required.

Linux, macOS, or WSL

curl -fsSL https://ravenstash.com/install.sh | bash

Windows PowerShell

irm https://ravenstash.com/install.ps1 | iex

For the complete operating-system, architecture, and signing matrix, see CLI platform support.

Sign in and choose a repository

Section titled “Sign in and choose a repository”
Terminal window
rvs auth login
rvs account list
rvs account switch AcmeHQ
rvs art select platform/packages

Use your Ravenstash username for personal work or an organization’s public handle for shared work. rvs account list shows the choices available to you.

Name-based repository targets use namespace/repository, as shown in Ravenstash. After you choose one, everyday commands stay short:

Terminal window
rvs pip install internal-sdk
rvs npm ci
rvs mvn verify

Run rvs status whenever you want to check which account and repository will be used.

Use a private mirror

Section titled “Use a private mirror”

Private mirrors are read-only and are available for PyPI, npm, and Maven sources.

Terminal window
rvs art mirror select pypiorg
rvs pip install requests

Choose a private repository again before publishing:

Terminal window
rvs art select platform/packages
rvs twine upload dist/*

Use another local profile

Section titled “Use another local profile”

A profile keeps a separate rvs sign-in and set of choices on the same computer. Most people need only the default profile. Use a named profile when you share a computer or need another Ravenstash sign-in:

Terminal window
rvs auth login --profile work
rvs profile use work

Keep rvs updated

rvs update
rvs update --apply

rvs update checks the rolling v0 release channel. Add --apply to install after review. APT installations delegate to APT; portable Linux, Alpine, macOS, and Windows installations authenticate, stage, health-check, and activate the matching bundle. Nix installations delegate replacement to Nix.

rvs update --to 0.MINOR previews the newest patch of one minor line. Add --apply to install it once, after confirmation. --yes is valid only with --apply.

Next steps

Section titled “Next steps”