Installer la CLI rzv

1. Installer sur macOS ou Linux

Le programme d'installation fournit rzv 0.21.0 (release-2026-10-31-193326). Il télécharge l'exécutable adapté à votre machine, vérifie sa somme de contrôle SHA-256 et l'installe dans ~/.local/bin. Aucune installation distincte de Node.js ni aucun environnement d'exécution séparé n'est nécessaire.

Exécutez cette commande dans un terminal macOS ou Linux. Si rzv est déjà installé, la même commande le met à jour.

curl -fsSL https://runzivo.dev/downloads/rzv/install.sh | sh
rzv version

Installation sous Windows ? Commencez ici →

Consulter les versions de rzv, les sommes de contrôle et les notes de version →

2. Se connecter

Connectez-vous avec l'identité GitHub que vous utilisez pour le portail client. La CLI ouvre votre navigateur sur id.runzivo.dev, puis conserve localement un jeton d'accès de courte durée. Elle n'affiche jamais de mot de passe ni de jeton dans le terminal.

Exécutez whoami après la connexion pour vérifier votre identité, votre profil et l'espace de travail sélectionné. Si vous mettez à jour depuis une version antérieure à 0.19.0, reconnectez-vous pour utiliser le fournisseur d'identité actuel.

rzv login
rzv whoami

3. Sélectionner un espace de travail

Listez les espaces de travail auxquels vous appartenez, puis remplacez <workspace-id> par un identifiant ou un slug de cette liste. La sélection est enregistrée pour les commandes suivantes liées à un espace de travail. Exécutez de nouveau whoami pour confirmer la sélection.

Passez --workspace <slug or id>, ou -w, pour utiliser un autre espace de travail le temps d'une commande. RZV_WORKSPACE définit l'espace de travail par défaut d'un shell. L'ancienne option --account <id> reste acceptée.

rzv workspaces list
rzv workspaces select <workspace-id>
rzv whoami

Référence des commandes d'espace de travail →

4. Exécuter votre première commande en lecture seule

Listez les tâches de l'espace de travail sélectionné. Ajoutez --json lorsqu'un script a besoin d'une sortie lisible par machine. Cette commande liste les tâches existantes ; elle ne démarre aucun flux de travail.

rzv jobs list
rzv jobs list --json
rzv help jobs

Lire la référence des commandes rzv →

Créer votre premier bac à sable →

Installation sous Windows

Sous Windows x86-64, téléchargez rzv-win32-x64.exe et SHA256SUMS depuis la même version. Ouvrez PowerShell dans le dossier de téléchargement et calculez l'empreinte SHA-256 de l'exécutable. Comparez-la à l'entrée correspondante de SHA256SUMS avant d'exécuter le fichier.

Après la vérification, renommez l'exécutable en rzv.exe et placez-le dans un dossier du PATH. Revenez à l'étape 2 pour vous connecter, puis sélectionnez un espace de travail. Le programme d'installation shell ci-dessus s'adresse à macOS et à Linux, pas à Windows.

Get-FileHash .\rzv-win32-x64.exe -Algorithm SHA256

Télécharger l'exécutable Windows et les sommes de contrôle →

Si rzv est introuvable

Le programme d'installation indique son dossier d'installation. Si votre shell ne trouve pas rzv, ajoutez ce dossier au PATH. Cet exemple utilise le dossier par défaut ~/.local/bin et s'applique au shell macOS ou Linux en cours. Ajoutez la même ligne au fichier de démarrage de votre shell pour la conserver dans les nouveaux terminaux.

Définissez RZV_INSTALL_DIR en exécutant le programme d'installation pour utiliser un autre dossier.

export PATH="$HOME/.local/bin:$PATH"
rzv version

Installer une version précise

Utilisez l'étiquette de version lorsque vous avez besoin d'une version fixe de la CLI. Cette commande installe la version documentée sur cette page.

curl -fsSL https://runzivo.dev/downloads/rzv/install.sh | sh -s -- --version=release-2026-10-31-193326

Plateformes prises en charge par la CLI

Des builds sont offerts pour macOS sur Apple Silicon et Intel, Linux sur x86-64 et arm64, et Windows sur x86-64. Chacun est un exécutable autonome.

Les fichiers de la version sont rzv-darwin-arm64, rzv-darwin-x64, rzv-linux-arm64, rzv-linux-x64 et rzv-win32-x64.exe.

Les plateformes de la CLI ne changent pas la disponibilité des exécuteurs. Les tâches Runzivo s'exécutent sur Linux x64 ; les exécuteurs macOS et Windows ne sont pas disponibles instantanément ; ils sont provisionnés sur demande (écrivez à run@runzivo.dev).

Utiliser un profil de connexion distinct

Chaque profil conserve sa propre connexion et son propre espace de travail sélectionné. Cet exemple crée un profil nommé work, liste les profils et active work. Utilisez -p <profile> sur n'importe quelle commande pour un choix ponctuel, ou définissez RZV_PROFILE pour un shell. Supprimer un profil supprime sa connexion locale.

rzv login -p work
rzv profiles list
rzv profiles use work
rzv whoami -p work

Se connecter sans ouvrir automatiquement le navigateur

Utilisez --no-browser pour afficher l'URL de connexion, puis ouvrez-la vous-même. Exécutez la CLI sur la même machine que le navigateur, car la connexion revient vers un écouteur de rappel local.

rzv login --no-browser

Se déconnecter

Cette commande supprime la connexion enregistrée pour le profil utilisé.

rzv logout

Dépannage de la CLI

• « Credentials were rejected or expired » : connectez-vous de nouveau avec la commande ci-dessous.
• « The requested workspace is not authorized for this account. » : listez vos espaces de travail et sélectionnez-en un auquel vous avez accès. Communiquez avec le soutien si vous vous attendez à avoir accès.
• « The customer API is unavailable » : patientez et réessayez ; communiquez avec le soutien si le problème persiste.
• Autorisation GitHub refusée ou code d'appareil expiré : le flux d'appareil de GitHub a été refusé ou a expiré. Relancez l'autorisation.
• Autorité d'installation GitHub refusée : vous devez être administrateur ou propriétaire de l'organisation. Si l'état du lien est invalide ou expiré, démarrez une nouvelle connexion.

rzv login
rzv workspaces list
rzv help github

Consulter le dépannage général et les coordonnées du soutien →

Commandes de connexion à GitHub →