Installation

Installez le CLI openspec sur votre machine, mettez-le à jour et désinstallez-le.

Installer

Sur macOS ou Linux, dans votre terminal :

curl -fsSL https://openspec.dev/cli/install.sh | sh

Sur Windows, dans PowerShell :

irm https://openspec.dev/cli/install.ps1 | iex

Si l'installateur affiche une ligne export PATH=..., exécutez-la. Puis vérifiez que cela a fonctionné.

Installer avec votre assistant IA

Collez ceci dans votre chat IA :

Fetch https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md and follow it.

Ou, dans votre terminal, redirigez-le vers un agent CLI (Claude Code montré) :

curl -fsSL https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md | claude

Cela récupère install.md à la racine du dépôt, une invite écrite pour tout agent capable d'exécuter des commandes shell (quelques intégrations IDE ne le peuvent pas). Attendez-vous à ce que votre assistant :

1. Ignore l'installation si le CLI est déjà sur votre machine, et propose de le mettre à jour selon la méthode d'installation utilisée. Si c'était npm ou Homebrew, mentionnez une fois que openspec install bascule vers l'installation autonome, sans insister. Sinon, montrez la commande d'installation ci-dessus et attendez votre confirmation avant de l'exécuter.
2. Utilise npm à la place uniquement si vous le demandez ou si l'installateur échoue, et s'arrête si votre Node est antérieur à 22.12.0.
3. Vérifie que openspec est sur votre PATH.
4. Nomme le dossier qu'il pense que vous voulez dire, suggère l'outil IA avec lequel vous dialoguez déjà, et demande quels autres vous utilisez, puis exécute openspec init dans ce dossier (l'étape configuration du projet).
5. Rapporte ce que init a créé et la syntaxe exacte pour invoquer OpenSpec dans votre outil.

Il s'arrête avant toute action privilégiée et ne modifie jamais vos fichiers de démarrage shell. La commande d'installation ci-dessus et les gestionnaires de paquets ci-dessous font foi, et l'invite les exécute pour vous.

Cette méthode d'installation est nouvelle et peut donner des résultats variables selon le modèle utilisé. N'utilisez-la que si vous êtes à l'aise pour corriger les erreurs de l'IA. Sinon, nous vous recommandons de suivre la méthode standard ci-dessous.

Gestionnaires de paquets

Ces méthodes installent OpenSpec en tant que paquet Node.js, elles nécessitent donc Node.js 22.12.0 ou plus récent (Homebrew et Nix apportent le leur). Dans votre terminal :

node --version

Si cela affiche v22.12.0 ou supérieur, installez avec npm :

npm install -g @fission-ai/openspec@latest

Sinon, installez un Node plus récent depuis nodejs.org ou via votre gestionnaire de versions (nvm, fnm, asdf, volta), ou utilisez plutôt l'installation autonome.

Homebrew

Homebrew installe OpenSpec et sa dépendance Node.js sur macOS ou Linux. Dans votre terminal :

brew install openspec

La formule est publiée dans homebrew-core, vous n'avez donc pas besoin d'ajouter un tap.

Yarn

yarn global add est réservé à Yarn Classic (1.x). Yarn moderne a supprimé les installations globales, utilisez donc npm, pnpm ou bun à la place. Un CLI global n'a pas besoin de partager le gestionnaire de paquets de votre projet.

Bun

Bun installe OpenSpec mais ne l'exécute pas, vous avez donc toujours besoin de Node sur votre machine (voir Gestionnaires de paquets). Sans lui, chaque commande échoue avec env: node: No such file or directory. Bun traite tous les CLI Node de cette façon.

Deno

Deno installe le CLI depuis npm et nécessite des indicateurs d'autorisation explicites. Dans votre terminal :

deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest

Certaines commandes lancent un autre programme : openspec config edit ouvre votre éditeur. Deno interrompt celles-ci avec une invite d'autorisation à chaque exécution. Pour qu'il arrête de demander, ajoutez un --allow-run=<program> ciblé à la commande d'installation.

NOTE

Si Deno ne parvient pas à résoudre @latest, épinglez une plage de versions à la place : npm:@fission-ai/openspec@^1.7.0.

Nix

Le dépôt OpenSpec fournit un flake Nix. Installez-le dans votre profil. Dans votre terminal :

nix profile install github:Fission-AI/OpenSpec

Ou exécutez d'abord une commande ponctuelle, sans installer :

nix run github:Fission-AI/OpenSpec -- --version

Cela ne laisse rien sur votre PATH, il n'y a donc pas d'installation à vérifier ensuite.

Pour mettre OpenSpec dans un dev shell de projet à la place, ajoutez le flake comme entrée et utilisez son paquet par défaut ; flake.nix liste les sorties.

Le paquet Nix fournit les scripts de complétion Bash, Fish et Zsh aux emplacements standards (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), ils sont donc chargés avec le paquet et il n'est pas nécessaire d'exécuter openspec completion install.

Vérifier que cela a fonctionné

Quelle que soit la méthode utilisée, dans votre terminal :

openspec --version

Si cela affiche un numéro de version, le CLI est sur votre PATH. Il s'installe une fois par machine.

Ensuite, configurez votre projet. Si votre assistant a déjà exécuté init, cette page montre ce qu'il a écrit et comment l'ajuster.

Options d'installation

Pour choisir une version ou un dossier, définissez une variable avant sh :

curl -fsSL https://openspec.dev/cli/install.sh | OPENSPEC_VERSION=v1.15.0 sh

• OPENSPEC_VERSION : la version à installer, par exemple v1.15.0. La valeur par défaut est la dernière version.
• OPENSPEC_INSTALL_DIR : le dossier d'installation. La valeur par défaut est ~/.local/bin (Windows : %LOCALAPPDATA%\Programs\openspec).

Sur Windows, définissez la variable d'abord :

$env:OPENSPEC_VERSION = 'v1.15.0'
irm https://openspec.dev/cli/install.ps1 | iex

Sur Alpine Linux, exécutez apk add libstdc++ libgcc avant d'installer.

Télécharger manuellement

Chaque version dispose d'un fichier par type d'ordinateur :

Ordinateur	Fichier
Mac, Apple silicon	openspec-darwin-arm64.tar.gz
Mac, Intel	openspec-darwin-x64.tar.gz
Linux, arm64	openspec-linux-arm64.tar.gz
Linux, x64	openspec-linux-x64.tar.gz
Alpine, arm64	openspec-linux-arm64-musl.tar.gz
Alpine, x64	openspec-linux-x64-musl.tar.gz
Windows, arm64	openspec-windows-arm64.zip
Windows, x64	openspec-windows-x64.zip

1. Téléchargez votre fichier depuis la dernière version. Les fichiers sont joints quelques minutes après la publication d'une version. Si le vôtre n'est pas encore listé, attendez et rechargez, ou prenez-le depuis la version précédente.
2. Décompressez-le. Dans votre terminal : tar -xzf openspec-darwin-arm64.tar.gz. Sur Windows, faites un clic droit sur le .zip et choisissez Extraire tout.
3. Sur macOS, exécutez xattr -d com.apple.quarantine openspec dans le dossier décompressé. macOS bloque les fichiers téléchargés dans un navigateur jusqu'à ce que vous le fassiez.
4. Déplacez openspec dans un dossier de votre PATH, tel que ~/.local/bin. Sur Windows, déplacez openspec.exe dans un dossier de votre PATH utilisateur, tel que %LOCALAPPDATA%\Programs\openspec.

Vérifier un téléchargement

Pour vérifier qu'un fichier a été construit par le workflow de publication OpenSpec, exécutez ceci avec le GitHub CLI :

gh attestation verify openspec-darwin-arm64.tar.gz --repo Fission-AI/OpenSpec

Cela échoue si le workflow n'a pas construit le fichier. La commande d'installation vérifie déjà chaque téléchargement par rapport au SHA256SUMS de la version, cette étape est donc facultative.

Basculer de npm vers l'installation autonome

La bascule est facultative ; npm continue de fonctionner. Vos paramètres et vos projets sont conservés ; seul le programme change.

1. Installez la copie autonome. Dans votre terminal :

openspec install

Cela installe le openspec autonome et affiche la commande qui supprime votre copie npm ou Homebrew.

2. Supprimez l'ancienne copie. Elle arrive généralement en premier sur votre PATH, donc jusqu'à ce qu'elle soit supprimée, elle continue de s'exécuter. Lancez la commande affichée à l'étape 1, par exemple :

npm uninstall -g @fission-ai/openspec

3. Vérifiez quelle copie s'exécute. Ouvrez un nouveau terminal :

openspec version

Cela doit afficher OpenSpec <version> (standalone). Si un gestionnaire de paquets est mentionné à la place, une autre copie est encore sur votre PATH : which -a openspec (Windows : where.exe openspec) liste toutes les copies, supprimez les autres.

Aucun projet n'a besoin d'être réinitialisé. Pour revenir en arrière, supprimez le fichier et relancez l'installation npm.

Mise à jour

Dans votre terminal, dans chaque projet où vous avez exécuté init :

openspec update

Lorsqu'un CLI plus récent est disponible, openspec update vous le signale et peut l'installer pour vous ; cette mise à niveau se fait une fois par machine. Chaque exécution rafraîchit les compétences et commandes générées du projet, qui ne se mettent jamais à jour d'elles-mêmes. Un projet à jour affiche ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Avec l'installation autonome, exécutez openspec install pour remplacer votre copie sur place ; openspec update vous indique quand une version plus récente est disponible. Sur Homebrew, exécutez brew upgrade openspec. Sur Deno, relancez l'installation Deno avec -f ; il ne remplacera pas la commande installée sans cela. Sur Nix, utilisez nix profile upgrade openspec.

NOTE

Une installation npm globale appartient à une installation de Node. Changez de version de Node avec nvm et la commande openspec ne suit pas, il faut donc la réinstaller sous la nouvelle version.

Désinstallation

Pour désinstaller OpenSpec, suivez les étapes ci-dessous ; aucune ne touche votre code source. Vous pouvez également diriger votre agent vers cette section et le laisser gérer la suppression.

1. Supprimez les complétions shell, si vous les avez configurées, tant que le CLI peut encore le faire. Dans votre terminal :

openspec completion uninstall

2. Supprimez le CLI. Pour l'installation autonome, supprimez ~/.local/bin/openspec (Windows : %LOCALAPPDATA%\Programs\openspec, et retirez ce dossier de votre PATH utilisateur). Pour npm, dans votre terminal :

npm uninstall -g @fission-ai/openspec

Sur Homebrew : brew uninstall openspec. Sur Deno : deno uninstall --global openspec. Sur Nix : nix profile remove openspec. Votre shell ne devrait plus trouver openspec.

3. Supprimez ce qui reste, ou conservez-le.

• Fichiers d'agent générés : compétences openspec-* et commandes opsx dans des dossiers comme .claude/ ou .agents/, par projet. La page Outils pris en charge liste les chemins de chaque outil ; MiniMax Code conserve les compétences dans ~/.minimax/skills.
• Résidus d'anciennes versions : blocs de marquage dans CLAUDE.md ou AGENTS.md (supprimez le bloc, conservez le fichier) et invites opsx-*.md dans ~/.codex/prompts.
• Le dossier openspec/ : faites une pause avant. specs/ et changes/archive/ sont votre trace du système, du Markdown brut qui se lit bien sans OpenSpec.
• État par machine : paramètres et identifiant de télémétrie dans ~/.config/openspec/ ; substitutions de schéma, enregistrements de dépôt et schémas intégrés de l'installation autonome (binary-schemas/) dans ~/.local/share/openspec/ (Windows : %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Les enregistrements sont des pointeurs ; les dépôts qu'ils désignent ne sont pas touchés.