Installation

codev est un binaire unique. Des binaires précompilés sont publiés sur GitHub Releases pour les plateformes suivantes :

Il existe quatre façons de l’installer. Les deux premières sont les plus rapides et ne nécessitent pas Rust.

macOS et Linux : install.sh

curl -sSL https://raw.githubusercontent.com/mairistem/codev/main/install.sh | sh

Le script détecte votre système et votre architecture, télécharge l’archive correspondante et le fichier SHA256SUMS depuis la dernière GitHub Release, vérifie l’empreinte SHA-256 de l’archive et installe le binaire dans ~/.local/bin/codev. Il refuse d’installer si l’empreinte ne correspond pas, et crée ~/.local/bin si nécessaire.

Si ~/.local/bin n’est pas dans votre PATH, le script affiche la ligne exacte à ajouter à ~/.zshrc ou ~/.bashrc :

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

Pour installer une version précise, définissez CODEV_VERSION :

curl -sSL https://raw.githubusercontent.com/mairistem/codev/main/install.sh | CODEV_VERSION=0.6.1 sh

Le script nécessite curl, tar, ainsi que sha256sum ou shasum.

Windows : install.ps1

Dans PowerShell 5.1 ou ultérieur (PowerShell 7 compris) :

iwr -useb https://raw.githubusercontent.com/mairistem/codev/main/install.ps1 | iex

Le script télécharge l’archive .zip et SHA256SUMS, vérifie l’archive avec Get-FileHash et copie codev.exe dans %LOCALAPPDATA%\Programs\codev\.

Il ne modifie pas votre PATH. Si le dossier est absent du PATH de votre utilisateur, il affiche la commande pour l’y ajouter :

[Environment]::SetEnvironmentVariable('PATH', [Environment]::GetEnvironmentVariable('PATH', 'User') + ";$env:LOCALAPPDATA\Programs\codev", 'User')

Cette commande ne modifie que le PATH utilisateur. Évitez setx PATH "$env:PATH;..." : cette commande tronque les valeurs de plus de 1 024 caractères et recopie le PATH de la machine dans le PATH utilisateur. Ouvrez ensuite une nouvelle fenêtre PowerShell pour que la modification prenne effet.

Pour installer une version précise :

$env:CODEV_VERSION = '0.6.1'
iwr -useb https://raw.githubusercontent.com/mairistem/codev/main/install.ps1 | iex

Sous Windows, seule l’architecture x86_64 (AMD64) est disponible en binaire précompilé. Sur ARM64, compilez depuis les sources.

Téléchargement manuel depuis GitHub Releases

Si vous préférez ne pas exécuter un script directement dans votre shell, téléchargez vous-même les fichiers depuis la dernière release. Chaque release contient une archive par cible, nommée codev-<version>-<target>.tar.gz (.zip sous Windows), ainsi qu’un fichier SHA256SUMS.

macOS et Linux. Téléchargez votre archive et SHA256SUMS dans le même dossier, puis :

# Vérifier l'empreinte — sur macOS : shasum -a 256 -c SHA256SUMS --ignore-missing
sha256sum -c SHA256SUMS --ignore-missing

tar -xzf codev-*.tar.gz
mkdir -p ~/.local/bin
cp codev-*/codev ~/.local/bin/
chmod 755 ~/.local/bin/codev

Windows. Téléchargez codev-<version>-x86_64-pc-windows-msvc.zip et SHA256SUMS, puis dans PowerShell :

# Vérifier l'empreinte
$zip = Get-Item codev-*-x86_64-pc-windows-msvc.zip
$expected = (Select-String -Path SHA256SUMS -Pattern $zip.Name).Line.Split(' ')[0]
$actual = (Get-FileHash $zip -Algorithm SHA256).Hash.ToLower()
if ($actual -ne $expected) { throw "SHA-256 mismatch" }

# Extraire et installer
Expand-Archive $zip -DestinationPath .
$dst = "$env:LOCALAPPDATA\Programs\codev"
New-Item -ItemType Directory -Path $dst -Force | Out-Null
Copy-Item codev-*\codev.exe $dst

Ajoutez ensuite le dossier au PATH de votre utilisateur comme indiqué plus haut.

Depuis les sources : cargo install

Avec une chaîne d’outils Rust (1.89 ou ultérieure), vous pouvez compiler codev à partir d’un clone du dépôt. C’est la voie à suivre pour les contributeurs et pour les plateformes sans binaire précompilé.

git clone https://github.com/mairistem/codev.git
cd codev
cargo install --path crates/codev-cli

Le binaire est installé dans ~/.cargo/bin/codev.

Vérifier l’installation

codev --version

Sous macOS et Linux, command -v codev indique quel binaire votre shell exécute. Sous Windows, utilisez Get-Command codev. Si la commande est introuvable, le dossier d’installation n’est pas dans votre PATH ; reportez-vous aux instructions ci-dessus pour votre plateforme.

Complétion du shell

codev completions <SHELL> écrit sur la sortie standard un script de complétion pour bash, zsh, fish, powershell ou elvish :

# bash
codev completions bash > ~/.local/share/bash-completion/completions/codev

# zsh — puis lancez `compinit`
codev completions zsh > "${fpath[1]}/_codev"

# fish
codev completions fish > ~/.config/fish/completions/codev.fish

# PowerShell, session en cours
codev completions powershell | Out-String | Invoke-Expression

Prérequis

• Claude Code, pour utiliser les skills. La CLI elle-même fonctionne sans.
• git, uniquement pour les sources héritées hébergées dans un dépôt git.

Mise à jour

Lancez codev self-update :

codev self-update                  # demande confirmation dans un terminal
codev self-update --check          # indique seulement la version installée et la plus récente
codev self-update --version 0.5.0  # une version précise, rétrogradation comprise

La commande télécharge la release la plus récente pour votre plateforme, vérifie son SHA-256 avec le SHA256SUMS de la release — comme le font les installateurs — et remplace le binaire sur place. Ensuite, dans un projet codev, elle lance codev update avec le nouveau binaire. Elle a besoin de curl et de tar, fournis par macOS, la plupart des distributions Linux et Windows 10 ou ultérieur.

codev self-update ne remplace qu’un binaire installé par install.sh, install.ps1 ou à la main. Si codev a été installé avec cargo install, compilé depuis un clone ou installé par un gestionnaire de paquets, elle affiche la commande qui le met à jour et ne modifie rien. Elle ne rétrograde jamais, sauf si vous passez --version. Sous Windows, l’ancien binaire est conservé sous le nom codev.old.exe à côté du nouveau, jusqu’à ce que la commande codev suivante le supprime.

codev status vous signale l’existence d’une release plus récente, au plus une fois par jour ; voir codev vérifie-t-il les mises à jour ? pour le désactiver.

Vous pouvez toujours relancer l’installateur ou télécharger une release plus récente. Ensuite, dans chaque projet, régénérez les skills pour qu’elles correspondent à la nouvelle version :

codev update

codev update rafraîchit aussi les sections gérées par codev dans CLAUDE.md et dans le modèle de pull request, ainsi que la version de codev épinglée dans .github/workflows/codev.yml, là où codev init les a écrites. Consultez codev update pour savoir comment sont traitées les skills modifiées à la main, et codev doctor pour vérifier le résultat.