Installation

Cette page explique comment installer l’outil en ligne de commande agent-rigger. Choisissez l’une des trois méthodes ci-dessous ; Homebrew est la méthode recommandée. Vérifiez ensuite les prérequis d’usage, puis validez le résultat.

Chaque méthode vous donne deux commandes pour le même outil : agent-rigger et la plus courte rigger.

Homebrew (recommandé)

Sur macOS et Linux, installez depuis le tap officiel :

brew tap agent-rigger/tap
brew install agent-rigger

Cela installe un binaire estampillé d’une version et l’alias rigger. La formule fournit des binaires natifs pour macOS (arm64 et x64) et Linux (arm64 et x64). Homebrew n’est pas disponible sur Windows ; utilisez plutôt le binaire de release ci-dessous.

Pour mettre à jour plus tard, brew upgrade agent-rigger.

Binaire de release préconstruit

Chaque release taguée publie sur GitHub un binaire autonome pour cinq cibles, plus un fichier de sommes de contrôle SHA256SUMS.txt. Les assets sont nommés :

• agent-rigger-darwin-arm64 : macOS, Apple Silicon
• agent-rigger-darwin-x64 : macOS, Intel
• agent-rigger-linux-arm64 : Linux, arm64
• agent-rigger-linux-x64 : Linux, x64
• agent-rigger-windows-x64.exe : Windows, x64

Téléchargez celui de votre plateforme (cet exemple utilise macOS Apple Silicon), vérifiez sa somme de contrôle, rendez-le exécutable et placez-le sur votre PATH :

base="https://github.com/agent-rigger/agent-rigger/releases/latest/download"
curl -fLO "$base/agent-rigger-darwin-arm64"
curl -fLO "$base/SHA256SUMS.txt"

# verify the download against the published checksum
shasum -a 256 -c SHA256SUMS.txt --ignore-missing

chmod +x agent-rigger-darwin-arm64
mv agent-rigger-darwin-arm64 /usr/local/bin/agent-rigger
ln -sf /usr/local/bin/agent-rigger /usr/local/bin/rigger

Les binaires de release ne sont pas signés. Sur macOS, un binaire téléchargé de cette façon peut être mis en quarantaine par Gatekeeper ; s’il est refusé au premier lancement, effacez l’attribut avec xattr -d com.apple.quarantine /usr/local/bin/agent-rigger.

Depuis les sources

Construire depuis les sources nécessite Bun 1.3 ou plus récent. Clonez le dépôt, installez les dépendances et construisez le binaire autonome :

git clone https://github.com/agent-rigger/agent-rigger.git
cd agent-rigger
bun install
bun run build

Le binaire compilé se trouve à packages/cli/dist/agent-rigger. Lancez-le directement, ou placez les deux noms sur votre PATH :

./packages/cli/dist/agent-rigger --version
ln -sf "$PWD/packages/cli/dist/agent-rigger" /usr/local/bin/agent-rigger
ln -sf "$PWD/packages/cli/dist/agent-rigger" /usr/local/bin/rigger

Version rapportée : un build depuis les sources dérive sa version de git. bun run build injecte git describe --tags --always --dirty (le v de tête retiré), si bien qu’un build depuis le dépôt cloné rapporte quelque chose comme 0.1.2-5-gabc123 — le dernier tag, les commits depuis, et le SHA court — avec un suffixe -dirty quand l’arbre de travail a des changements non commités. Le sentinel 0.0.0 n’apparaît que quand git est indisponible, par exemple un arbre de sources extrait d’une tarball sans .git. Le build de release en CI estampille le tag exact à la place.

Prérequis d’usage

agent-rigger s’appuie sur quelques outils externes. Il fonctionne sans les avoir tous, mais avec moins de garanties.

• git — requis. Les catalogs sont des dépôts git ; l’outil les récupère avec git. Sans git, il ne peut lire aucun catalog.
• gitleaks et/ou trivy — recommandés. Ce sont les scanners qui inspectent le contenu récupéré du catalog à la recherche de secrets fuités et de misconfigurations avant qu’il ne soit écrit sur le disque. Si aucun des deux n’est installé, l’outil ne peut pas scanner et bascule en mode warn-only : il installe quand même et affiche un avertissement, plutôt que de bloquer chaque install. Cela signifie qu’un contenu non scanné atteint votre poste, si bien qu’installer au moins un scanner est ce qui rend le contrôle de sécurité réel. Les compromis sont exposés dans confiance et sécurité.
• Un assistant — requis en pratique. agent-rigger configure Claude Code ou opencode ; installez-en au moins un, sinon il n’a rien à configurer.

Vérifier l’installation

Deux commandes confirment une installation fonctionnelle. D’abord, la version :

rigger --version

Une install Homebrew ou de release affiche la version publiée ; un build depuis les sources affiche sa version dérivée de git (0.0.0 seulement si construit sans git disponible — voir la note ci-dessus).

Lancez ensuite doctor, qui indique si git et les scanners sont présents et dans quel mode de scan vous êtes :

rigger doctor

Un poste où les scanners sont installés indique le mode full scan :

--- rigger doctor ---

✓ git (/opt/homebrew/bin/git)
✓ glab (/opt/homebrew/bin/glab)
✓ gitleaks (/opt/homebrew/bin/gitleaks)
✓ trivy (/opt/homebrew/bin/trivy)

mode : full scan

Installed state is healthy — no findings.

Sans gitleaks ni trivy, la ligne de mode affiche à la place mode : warn-only (external content not scanned — install gitleaks or trivy).

La suite

• Parcourez votre premier rig en une dizaine de minutes.
• Comprenez à quoi sert agent-rigger.