OpenSpec

Installation ​

Prérequis ​

  • Node.js 20.19.0 ou supérieur — Vérifiez votre version : node --version

Installation avec votre assistant IA ​

Vous préférez ne pas le faire manuellement ? Collez l'invite ci-dessous dans n'importe quel assistant de codage capable d'exécuter des commandes shell — Claude Code, Codex, Cursor, Gemini CLI, Copilot, et le reste des outils pris en charge. Il installe le CLI, initialise ce projet et rapporte ce qui s'est réellement passé.

Les étapes manuelles ci-dessous sont la source de vérité — l'invite ne fait que les exécuter pour vous. Si votre assistant s'arrête et vous rend quelque chose, c'est voulu : il demande avant toute action privilégiée et ne modifie jamais vos fichiers de démarrage shell. Terminez ces étapes vous-même avec les Gestionnaires de paquets et le Dépannage.

text
Install OpenSpec in this project and set it up for me. Follow these steps in
order, and stop where a step tells you to stop.

1. RUNTIME. Run `node --version`. OpenSpec needs Node.js 20.19.0 or higher. If
   Node is missing or older, say so and stop — don't install Node, switch
   versions, or reconfigure my version manager for me.

2. INSTALL. Use whichever package manager is already on my PATH, preferring npm:
     npm install -g @fission-ai/openspec@latest
     pnpm add -g @fission-ai/openspec@latest
     bun add -g @fission-ai/openspec@latest
     yarn global add @fission-ai/openspec@latest   (Yarn 1.x only)
   Don't pick based on this project's lockfile — a global install has nothing to
   do with how this repo's own dependencies are installed. If none of those four
   is available, stop and tell me — don't improvise an install. (If I'm on Nix,
   point me at the Nix section of the OpenSpec installation docs instead.)
   Show me the exact command and let me confirm before you run it; this installs
   software outside the project, and I may want a different package manager to
   own it.
   Stop and ask me again if the install needs sudo or admin rights, fails with a
   permissions error, or reports that its global bin directory is missing or
   unconfigured. Never edit my shell startup files (.bashrc, .zshrc, .profile,
   fish, PowerShell profile), and never run a setup command that edits them for
   me — show me the change and let me make it.

3. PATH. Run `openspec --version`. If the command isn't found, it may just be
   missing from this shell: tell me where the package manager installed it and
   how to add that directory to PATH for my shell and OS, then stop until I
   confirm. If it prints an older version than the one the install just
   reported, an earlier copy is shadowing it on PATH — tell me both versions
   instead of continuing. If I use a version manager, say so rather than editing
   PATH around it: with nvm or fnm the CLI is tied to the Node version that was
   active when you installed it, and with asdf or volta a shim may need
   regenerating.

4. INITIALIZE. Ask me which AI coding tool or tools I use and map each to an id
   from `openspec init --help` (Copilot is `github-copilot`, Zoo Code is
   `roocode`). `--tools` takes a comma-separated list, so name all of them.
   `openspec init --tools <ids>` deletes leftovers from older OpenSpec versions
   automatically, without asking — including `opsx-*.md` prompt files in my home
   directory (Codex keeps them in ~/.codex/prompts). Before you run it, look for
   those: `.../commands/openspec/` folders, OpenSpec marker blocks in files like
   CLAUDE.md or AGENTS.md, and home-directory `opsx-*.md` prompts. List whatever
   you find and wait for my go-ahead; if you find nothing, say so and carry on
   without asking. An existing `openspec/` folder is not a problem — init
   refreshes it and leaves my specs and changes alone.
   Confirm I'm in the right folder too: init creates `openspec/` wherever it
   runs, including inside a monorepo package.
   Then run: openspec init --tools <ids>

5. REPORT. Don't assume what should exist — tell me what init actually printed:
   how many skills and/or commands it created and where, the config file line,
   any "Setup required" note, and what to restart or reload. Some tools are
   skills-only and correctly create zero command files, so missing commands is
   not a failure on its own. If init said nothing was generated, relay the fix
   it suggested instead of retrying. Finish by telling me how to invoke OpenSpec
   in my tool, and take the exact spelling from the files init created rather
   than from its summary line: the punctuation differs per tool (/opsx:propose
   in some, /opsx-propose in others, @opsx-propose in Amazon Q), and tools that
   get skills instead of commands are invoked by skill name (/openspec-propose,
   or $openspec-propose in Codex, or /skill:openspec-propose in Kimi Code).

Rien dans l'invite n'est spécifique à un fournisseur : ce sont de simples instructions accompagnées des mêmes commandes documentées sur cette page. Elle fonctionne sur macOS, Linux et Windows, et elle s'arrête délibérément plutôt que d'improviser lorsqu'une étape nécessite votre autorisation. Votre assistant doit être capable d'exécuter des commandes shell — certaines intégrations IDE ne le peuvent pas.

Gestionnaires de paquets ​

npm ​

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

pnpm ​

bash
pnpm add -g @fission-ai/openspec@latest

yarn ​

bash
yarn global add @fission-ai/openspec@latest

Yarn 2 et ultérieurs (Berry) ont supprimé la commande global. Sur ces versions, installez OpenSpec avec npm, pnpm ou bun à la place — un CLI global n'a pas besoin de partager le gestionnaire de paquets de votre projet.

deno ​

Deno rencontre parfois des problèmes pour analyser le tag @latest, mais vous pouvez spécifier une version lors de l'installation initiale. Si cela se produit, vous pouvez essayer de remplacer le tag @latest par une version, par exemple @^1.3.1

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

Remarque : si vos sous-commandes lancent des outils externes, comme config edit, feedback ou workspace open, vous devrez peut-être ajouter un --allow-run=<programme> ciblé.

bun ​

Bun peut installer OpenSpec globalement, mais OpenSpec fonctionne actuellement sur Node.js. Vous avez toujours besoin de Node.js 20.19.0 ou supérieur disponible sur PATH.

bash
bun add -g @fission-ai/openspec@latest

Nix ​

Exécutez OpenSpec directement sans installation :

bash
nix run github:Fission-AI/OpenSpec -- init

Ou installez-le dans votre profil :

bash
nix profile install github:Fission-AI/OpenSpec

Ou ajoutez-le à votre environnement de développement dans flake.nix :

nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    openspec.url = "github:Fission-AI/OpenSpec";
  };

  outputs = { nixpkgs, openspec, ... }: {
    devShells.x86_64-linux.default = nixpkgs.legacyPackages.x86_64-linux.mkShell {
      buildInputs = [ openspec.packages.x86_64-linux.default ];
    };
  };
}

Vérification de l'installation ​

bash
openspec --version

Mise à jour ​

Mettez à jour le paquet, puis actualisez les fichiers générés de chaque projet :

bash
npm install -g @fission-ai/openspec@latest   # ou l'équivalent pnpm/yarn/bun
openspec update                              # à exécuter dans chaque projet

openspec update régénère les fichiers de compétences et de commandes pour les outils que vous avez configurés, afin que vos commandes slash restent à jour avec la version installée. Il vérifie également si une version plus récente du CLI a été publiée et propose de mettre à jour, car c'est la mise à jour qui rend les nouveaux flux de travail disponibles — voir Référence CLI.

Désinstallation ​

Il n'existe pas de commande openspec uninstall, car OpenSpec n'est qu'un paquet global accompagné de quelques fichiers dans votre projet. Sa suppression se fait en quelques étapes manuelles, et rien ici ne touche à votre code source.

1. Supprimer le paquet global :

bash
npm uninstall -g @fission-ai/openspec   # ou : pnpm rm -g / yarn global remove / bun rm -g

2. Supprimer OpenSpec d'un projet (facultatif). Supprimez le répertoire openspec/ si vous ne souhaitez plus conserver ses spécifications et modifications :

bash
rm -rf openspec/

Réfléchissez avant de faire cela : openspec/specs/ et openspec/changes/archive/ constituent votre historique de la façon dont le système se comporte et pourquoi il a changé. Si vous pourriez vouloir conserver cet historique, gardez le dossier (ou conservez-le dans git) même après la désinstallation.

3. Supprimer les fichiers d'outils IA générés (facultatif). OpenSpec écrit des fichiers de compétences et de commandes dans des répertoires par outil tels que .claude/skills/openspec-*/, .cursor/commands/opsx-*, etc. Supprimez les compétences openspec-* et les commandes opsx-* pour les outils que vous avez configurés. Les chemins exacts par outil sont listés dans Outils pris en charge.

Si vous avez également des blocs marqueurs OpenSpec dans des fichiers comme CLAUDE.md ou AGENTS.md, supprimez ces blocs manuellement ; votre propre contenu dans ces fichiers vous appartient.

Étapes suivantes ​

Après l'installation, initialisez OpenSpec dans votre projet :

bash
cd your-project
openspec init

Consultez Premiers pas pour un guide complet.