Installatie

Installeer de openspec CLI op uw machine, werk deze bij en oninstalleer deze.

Installeren

Op macOS of Linux, in uw terminal:

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

Op Windows, in PowerShell:

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

Als de installatieprogramma export PATH=... weergeeft, voer dit uit. Controleer daarna of het gelukt is.

Installeren met uw AI-assistent

Plak dit in uw AI-chat:

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

Of, in uw terminal, pipe het naar een CLI-agent (Claude Code getoond):

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

Dit haalt install.md in de repository root op, een prompt geschreven voor elke agent die shell-commando's kan uitvoeren (enkele IDE-integraties kunnen dat niet). Verwacht dat uw assistent:

1. De installatie over slaat als de CLI al op uw machine staat, en aanbiedt om deze op te werken via de methode waarmee deze geïnstalleerd is. Als dat npm of Homebrew was, meldt het een keer dat openspec install overschakelt naar de standalone installatie, zonder het door te duwen. Anders toont het u het installatiecommando hierboven en wacht het uw bevestiging af voordat het wordt uitgevoerd.
2. Alleen npm gebruikt als u dat vraagt of als de installatie mislukt, en stopt als uw Node ouder is dan 22.12.0.
3. Verifieert of openspec op uw PATH staat.
4. De map noemt waarvan het denkt dat u die bedoelt, suggereert de AI-tool waar u al mee praat en vraagt welke andere tools u gebruikt, en voert daar vervolgens openspec init uit (de projectinstellingsstap).
5. Rapporteert wat init heeft aangemaakt en de exacte spelling om OpenSpec in uw tool aan te roepen.

Het stopt vóórdat er gepersonifieerde acties worden uitgevoerd en bewerkt uw shell-startbestanden nooit. Het installatiecommando hierboven en de pakketbeheerders hieronder zijn de bron van waarheid, en de prompt voert ze voor u uit.

Deze installatiemethode is nieuw en kan, afhankelijk van het gebruikte model, wisselende resultaten opleveren. Gebruik dit alleen als u zich prettig voelt met het corrigeren van AI-fouten. Anders raden we aan de standaardmethode hieronder te volgen.

Pakketbeheerders

Deze installeren OpenSpec als een Node.js-pakket, dus ze hebben Node.js 22.12.0 of nieuwer nodig (Homebrew en Nix leveren hun eigen). In uw terminal:

node --version

Als dit v22.12.0 of hoger weergeeft, installeer dan met npm:

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

Als dat niet het geval is, installeer dan een nieuwere Node vanaf nodejs.org of via uw versiebeheerder (nvm, fnm, asdf, volta), of gebruik in plaats daarvan de standalone installatie.

Homebrew

Homebrew installeert OpenSpec en de Node.js-afhankelijkheid op macOS of Linux. In uw terminal:

brew install openspec

De formula is gepubliceerd in homebrew-core, dus u hoeft geen tap toe te voegen.

Yarn

yarn global add is alleen voor Yarn Classic (1.x). Moderne Yarn heeft globale installaties verwijderd, dus gebruik npm, pnpm of bun in plaats daarvan. Een globale CLI hoeft niet uw projectpakketbeheerder te delen.

Bun

Bun installeert OpenSpec, maar voert het niet uit, dus u heeft nog steeds Node op uw machine nodig (zie Pakketbeheerders). Zonder het faalt elk commando met env: node: No such file or directory. Bun behandelt elke Node CLI op deze manier.

Deno

Deno installeert de CLI vanaf npm en heeft expliciete permissievlaggen nodig. In uw terminal:

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

Sommige commando's starten een ander programma: openspec config edit opent uw editor. Deno onderbreekt deze met een permissieprompt bij elke uitvoering. Om het vragen te stoppen, voegt u een gescope --allow-run=<program> toe aan het installatiecommando.

NOTE

Als Deno @latest niet kan oplossen, vaste versiebereik vast in plaats van: npm:@fission-ai/openspec@^1.7.0.

Nix

De OpenSpec-repository levert een Nix flake. Installeer deze in uw profiel. In uw terminal:

nix profile install github:Fission-AI/OpenSpec

Of voer eerst een eenmalig commando uit, zonder te installeren:

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

Dit laat niets achter op uw PATH, dus er is geen installatie om achteraf te controleren.

Om OpenSpec in een project-ontwikkelshell in plaats daarvan te plaatsen, voegt u de flake toe als invoer en gebruikt u zijn standaardpakket; flake.nix noemt de outputs.

Het Nix-pakket levert de Bash, Fish en Zsh completion-scripts op de standaardlocaties (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), dus ze laden met het pakket en er is geen need om openspec completion install uit te voeren.

Controles of het gelukt is

Ongeacht welke methode u heeft gebruikt, in uw terminal:

openspec --version

Als dit een versienummer weergeeft, staat de CLI op uw PATH. Deze wordt één keer per machine geïnstalleerd.

Vervolgens, stel uw project in. Als uw assistent init al heeft uitgevoerd, toont die pagina wat het heeft geschreven en hoe u het kunt aanpassen.

Installatieopties

Om een versie of map te kiezen, stelt u een variabele in vóór sh:

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

• OPENSPEC_VERSION: de release die wordt geïnstalleerd, zoals v1.15.0. De standaard is de nieuwste release.
• OPENSPEC_INSTALL_DIR: de map waarin wordt geïnstalleerd. De standaard is ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

Op Windows, stelt u de variabele eerst in:

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

Op Alpine Linux, voer apk add libstdc++ libgcc uit vóór installatie.

Handmatig downloaden

Elke release heeft één bestand per computer:

Computer	Bestand
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. Download uw bestand van de nieuwste release. Bestanden zijn een paar minuten na publicatie van een release bijgevoegd. Als de uwe nog niet staat, wacht dan en vernieuw, of neem het van de vorige release.
2. Ontpakk het. In uw terminal: tar -xzf openspec-darwin-arm64.tar.gz. Op Windows, klik met de rechtermuisknop op de .zip en kies Extract All.
3. Op macOS, voer xattr -d com.apple.quarantine openspec uit in de map waarin u heeft ontpakt. macOS blokkeert bestanden gedownload in een browser tot u dit doet.
4. Verplaats openspec naar een map op uw PATH, zoals ~/.local/bin. Op Windows, verplaats openspec.exe naar een map op uw gebruikers-PATH, zoals %LOCALAPPDATA%\Programs\openspec.

Een download verifiëren

Om te controleren of een bestand is gebouwd door de OpenSpec release-workflow, voer dit uit met de GitHub CLI:

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

Het mislukt als de workflow het bestand niet heeft gebouwd. Het installatiecommando controleert al elke download tegen de SHA256SUMS van de release, dus deze stap is optioneel.

Overschakelen van npm naar de standalone installatie

Overschakelen is optioneel; npm blijft werken. Uw instellingen en projecten gaan over; alleen het programma verandert.

1. Installeer de standalone kopie. In uw terminal:

openspec install

Het installeert de standalone openspec en toont het commando dat uw npm- of Homebrew-kopie verwijdert.

2. Verwijder de oude kopie. Het staat meestal eerst op uw PATH, dus zolang het daar staat, blijft het die uitvoeren in plaats van de nieuwe. Voer het commando uit dat stap 1 heeft getoond, bijvoorbeeld:

npm uninstall -g @fission-ai/openspec

3. Controleer welke kopie wordt uitgevoerd. Open een nieuwe terminal:

openspec version

Het zou OpenSpec <version> (standalone) moeten tonen. Als het een pakketbeheerder noemt, staat er nog een andere kopie op uw PATH: which -a openspec (Windows: where.exe openspec) noemt elke kopie, dus verwijder de andere.

Geen project heeft herinitialisatie nodig. Om terug te schakelen, verwijder het bestand en voer de npm installatie opnieuw uit.

Bijwerken

In uw terminal, in elk project waar u init heeft uitgevoerd:

openspec update

Wanneer een nieuwere CLI beschikbaar is, zegt openspec update dat en kan het voor u installeren; die upgrade is één keer per machine. Elke uitvoering vernieuwt de gegenereerde vaardigheden en commando's van het project, die nooit vanzelf bijwerken. Een actueel project toont ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Met de standalone installatie, voer openspec install uit om uw kopie ter plaatse te vervangen; openspec update vertelt u wanneer er een nieuwere is. Op Homebrew, voer brew upgrade openspec uit. Op Deno, voer de Deno-installatie opnieuw uit met -f; zonder het overschrijft het de geïnstalleerde commando niet. Op Nix, gebruik nix profile upgrade openspec.

NOTE

Een globale npm-installatie behoort tot één Node-installatie. Schakel Node-versies over met nvm en het openspec-commando komt niet mee, dus installeer het opnieuw onder de nieuwe versie.

Deïnstalleren

Om OpenSpec te deïnstalleren, voer de onderstaande stappen uit; geen van hen raakt uw broncode aan. U kunt ook uw agent naar deze sectie sturen en de verwijdering laten uitvoeren.

1. Verwijder de shell-completions, als u ze hebt ingesteld, terwijl de CLI het nog kan. In uw terminal:

openspec completion uninstall

2. Verwijder de CLI. Voor de standalone installatie, verwijder ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec, en die map van uw gebruikers-PATH). Voor npm, in uw terminal:

npm uninstall -g @fission-ai/openspec

Op Homebrew: brew uninstall openspec. Op Deno: deno uninstall --global openspec. Op Nix: nix profile remove openspec. Uw shell zou openspec niet meer moeten vinden.

3. Verwijder wat er over is, of bewaar het.

• Gegenereerde agentbestanden: openspec-* vaardigheden en opsx commando's in mappen zoals .claude/ of .agents/, per project. Ondersteunde tools noemt de paden van elke tool; MiniMax Code bewaart vaardigheden in ~/.minimax/skills.
• Overblijfselen van oudere versies: markerblokken in CLAUDE.md of AGENTS.md (verwijder de blok, bewaar de bestand) en opsx-*.md prompts in ~/.codex/prompts.
• De openspec/ map: pauzeer eerst. specs/ en changes/archive/ zijn uw registratie van het systeem, gewoon Markdown dat goed te lezen is zonder OpenSpec.
• Per-machine status: instellingen en de telemetrie-id in ~/.config/openspec/; schema-overrides, store-registraties en de ingebouwde schemas van de standalone installatie (binary-schemas/) in ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Registraties zijn wijsers; de repo's die ze wijzen naar onaangetast.