---
title: Installation
description: Installez gwm depuis les sources, Homebrew, des binaires précompilés ou un flake Nix.
---
# Installation
gwm est livré sous forme d'un unique binaire autonome. Choisissez le canal qui correspond à votre workflow — ils produisent tous le même exécutable `gwm`.
## depuis les sources
```bash
git clone https://github.com/kbrdn1/gwm-cli.git
cd gwm-cli
cargo install --path .
```
Le binaire arrive dans `~/.cargo/bin/gwm`. Nécessite une toolchain Rust stable récente — le MSRV est **1.86**.
## via cargo-binstall
```bash
cargo binstall gwm-cli
```
[`cargo-binstall`](https://github.com/cargo-bins/cargo-binstall) lit le bloc `[package.metadata.binstall]` du `Cargo.toml` de `gwm`, télécharge l'archive précompilée correspondant au triple de votre hôte depuis la GitHub Release, l'extrait et dépose le binaire dans `~/.cargo/bin/`. Aucune toolchain Rust ni compilation C de `git2`/libgit2 n'est nécessaire au moment de l'installation — bien plus rapide que `cargo install` au premier lancement.
Les métadonnées pointent vers les mêmes artefacts que ceux publiés par le workflow de release (`gwm-v{version}-{target}.tar.gz`, ou `.zip` sous Windows), de sorte que toute release taguée est binstall-able. `tests/binstall_metadata_tests.rs` verrouille le bloc contre toute dérive.
## via Homebrew (macOS)
```bash
brew tap kbrdn1/tap
brew install gwm
```
La formule se trouve dans [`kbrdn1/homebrew-tap`](https://github.com/kbrdn1/homebrew-tap) (`Formula/gwm.rb`) et est rafraîchie automatiquement à chaque release **stable** de `gwm-cli` par le job `homebrew-tap-update` de [`release.yml`](https://github.com/kbrdn1/gwm-cli/blob/main/.github/workflows/release.yml). Le template canonique de la formule se trouve dans [`packaging/homebrew/gwm.rb.template`](https://github.com/kbrdn1/gwm-cli/blob/main/packaging/homebrew/gwm.rb.template). Les tags de pré-release (`-rc.N`, `-alpha.N`, `-beta.N`) sont filtrés, donc `brew install gwm` pointe toujours vers un build stable.
Voir [Intégrations → Homebrew & Nix](/fr/integrations/homebrew-nix) pour le détail du pipeline de mise à jour du tap et des sorties du flake.
## binaires précompilés
Les releases sur <https://github.com/kbrdn1/gwm-cli/releases> fournissent des binaires signés accompagnés de sidecars `.sha256` pour :
- Linux (`x86_64`, `aarch64`)
- macOS (Intel, Apple Silicon)
- Windows (`x86_64`)
Déposez le binaire sur votre `$PATH`, rendez-le exécutable, et c'est terminé.
## via un flake Nix
Un `flake.nix` se trouve à la racine du dépôt. Avec les flakes activés :
```bash
# exécution one-shot, sans clone
nix run github:kbrdn1/gwm-cli -- list
# installer dans votre profil
nix profile install github:kbrdn1/gwm-cli
# dans une config NixOS / nix-darwin, via l'overlay
nixpkgs.overlays = [ inputs.gwm.overlays.default ];
environment.systemPackages = [ pkgs.gwm ];
```
Le paquet est construit via `rustPlatform.buildRustPackage` et épingle `Cargo.lock` ; la feature `vendored-libgit2` de `git2` garde la closure exempte de libgit2 système.
## vérifier l'installation
```bash
gwm --version
gwm doctor # exécute une batterie de vérifications de cohérence
```
Si `gwm doctor` renvoie un code non nul, rendez-vous sur [`gwm doctor`](/fr/integrations/doctor) pour les conseils de remédiation par vérification.
## suite
- [Créer votre premier worktree](/fr/getting-started/first-worktree)
- [Configurer `gcd` pour un `cd` en une ligne vers un worktree](/fr/getting-started/shell-init)