Installation

Installieren Sie die openspec CLI auf Ihrem Rechner, aktualisieren Sie sie und deinstallieren Sie sie.

Installation

Unter macOS oder Linux, in Ihrem Terminal:

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

Unter Windows, in PowerShell:

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

Wenn das Installationsskript eine Zeile export PATH=... ausgibt, führen Sie diese aus. Anschließend prüfen Sie, ob es funktioniert hat.

Installation mit Ihrem KI-Assistenten

Fügen Sie Folgendes in Ihren KI-Chat ein:

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

Oder, in Ihrem Terminal, leiten Sie es an einen CLI-Agenten um (Claude Code als Beispiel):

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

Dies ruft install.md im Stammverzeichnis des Repositories ab, einen Prompt, der für jeden Agenten geschrieben wurde, der Shell-Befehle ausführen kann (einige IDE-Integrationen können dies nicht). Erwarten Sie von Ihrem Assistenten:

1. Die Installation zu überspringen, wenn die CLI bereits auf Ihrem Rechner vorhanden ist, und anzubieten, sie auf die gleiche Weise zu aktualisieren, wie sie installiert wurde. Wenn dies npm oder Homebrew war, einmal erwähnen, dass openspec install zur Standalone-Installation wechselt, ohne darauf zu drängen. Andernfalls zeigen Sie den Installationsbefehl oben an und warten Sie auf Ihre Bestätigung, bevor er ausgeführt wird.
2. npm nur dann zu verwenden, wenn Sie danach fragen oder das Installationsskript fehlschlägt, und anzuhalten, wenn Ihr Node älter als 22.12.0 ist.
3. Zu überprüfen, dass openspec in Ihrem PATH ist.
4. Den Ordner zu benennen, den Sie meinen, das KI-Tool vorzuschlagen, mit dem Sie bereits sprechen, und zu fragen, welche anderen Sie verwenden, dann openspec init dort auszuführen (den Schritt Projekt einrichten).
5. Zu berichten, was init erstellt hat und die genaue Schreibweise, um OpenSpec in Ihrem Tool aufzurufen.

Es hält vor allen privilegierten Aktionen an und bearbeitet nie Ihre Shell-Startdateien. Der Installationsbefehl oben und die Paketmanager unten sind die Quelle der Wahrheit, und der Prompt führt sie für Sie aus.

Diese Installationsmethode ist neu und kann je nach verwendetem Modell unterschiedliche Ergebnisse liefern. Verwenden Sie sie nur, wenn Sie damit einverstanden sind, KI-Fehler zu korrigieren. Andernfalls empfehlen wir, die Standardmethode unten zu befolgen.

Paketmanager

Diese installieren OpenSpec als Node.js-Paket, benötigen also Node.js 22.12.0 oder neuer (Homebrew und Nix bringen ihre eigene Version mit). In Ihrem Terminal:

node --version

Wenn dies v22.12.0 oder höher ausgibt, installieren Sie mit npm:

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

Falls nicht, installieren Sie ein neueres Node von nodejs.org oder über Ihren Versionsmanager (nvm, fnm, asdf, volta), oder verwenden Sie stattdessen die Standalone-Installation.

Homebrew

Homebrew installiert OpenSpec und seine Node.js-Abhängigkeit unter macOS oder Linux. In Ihrem Terminal:

brew install openspec

Die Formel wird in homebrew-core veröffentlicht, Sie müssen also keinen Tap hinzufügen.

Yarn

yarn global add ist nur für Yarn Classic (1.x). Modernes Yarn hat globale Installationen entfernt, verwenden Sie also stattdessen npm, pnpm oder bun. Eine globale CLI muss nicht den Paketmanager Ihres Projekts teilen.

Bun

Bun installiert OpenSpec, führt es aber nicht aus, Sie benötigen also weiterhin Node auf Ihrem Rechner (siehe Paketmanager). Ohne Node schlägt jeder Befehl mit env: node: No such file or directory fehl. Bun behandelt jede Node-CLI auf diese Weise.

Deno

Deno installiert die CLI von npm und benötigt explizite Berechtigungsflags. In Ihrem Terminal:

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

Einige Befehle starten ein anderes Programm: openspec config edit öffnet Ihren Editor. Deno unterbricht diese mit einer Berechtigungsabfrage bei jedem Lauf. Um dies zu verhindern, fügen Sie der Installationsbefehl einen bereichsbezogenen --allow-run=<programm> hinzu.

NOTE

Wenn Deno @latest nicht auflösen kann, pin Sie stattdessen einen Versionsbereich fest: npm:@fission-ai/openspec@^1.7.0.

Nix

Das OpenSpec-Repository enthält einen Nix-Flake. Installieren Sie ihn in Ihr Profil. In Ihrem Terminal:

nix profile install github:Fission-AI/OpenSpec

Oder führen Sie zuerst einen einmaligen Befehl aus, ohne zu installieren:

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

Dies hinterlässt nichts in Ihrem PATH, daher gibt es danach keine Installation, die überprüft werden müsste.

Um OpenSpec stattdessen in eine Projekt-Dev-Shell einzufügen, fügen Sie den Flake als Eingabe hinzu und verwenden Sie dessen Standardpaket; flake.nix listet die Ausgaben auf.

Das Nix-Paket enthält die Bash-, Fish- und Zsh-Vervollständigungsskripte an den Standardorten (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), sodass sie mit dem Paket geladen werden und kein openspec completion install ausgeführt werden muss.

Prüfen, ob es funktioniert hat

Unabhängig von der verwendeten Methode, in Ihrem Terminal:

openspec --version

Wenn dies eine Versionsnummer ausgibt, ist die CLI in Ihrem PATH. Sie wird einmal pro Rechner installiert.

Als Nächstes richten Sie Ihr Projekt ein. Wenn Ihr Assistent init bereits ausgeführt hat, zeigt diese Seite, was er geschrieben hat und wie Sie es anpassen können.

Installationsoptionen

Um eine Version oder einen Ordner auszuwählen, setzen Sie vor sh eine Variable:

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

• OPENSPEC_VERSION: die zu installierende Version, z. B. v1.15.0. Der Standard ist die neueste Version.
• OPENSPEC_INSTALL_DIR: der Ordner, in den installiert wird. Der Standard ist ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

Unter Windows setzen Sie die Variable zuerst:

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

Unter Alpine Linux führen Sie vor der Installation apk add libstdc++ libgcc aus.

Manuell herunterladen

Jede Version hat eine Datei pro Rechner:

Rechner	Datei
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. Laden Sie Ihre Datei vom neuesten Release herunter. Dateien werden einige Minuten nach der Veröffentlichung eines Releases angehängt. Wenn Ihre noch nicht aufgeführt ist, warten Sie und laden Sie neu, oder nehmen Sie sie vom vorherigen Release.
2. Entpacken Sie sie. In Ihrem Terminal: tar -xzf openspec-darwin-arm64.tar.gz. Unter Windows klicken Sie mit der rechten Maustaste auf die .zip und wählen Sie „Alle extrahieren".
3. Unter macOS führen Sie xattr -d com.apple.quarantine openspec in dem Ordner aus, in den Sie entpackt haben. macOS blockiert im Browser heruntergeladene Dateien, bis Sie dies tun.
4. Verschieben Sie openspec in einen Ordner in Ihrem PATH, z. B. ~/.local/bin. Unter Windows verschieben Sie openspec.exe in einen Ordner in Ihrem Benutzer-PATH, z. B. %LOCALAPPDATA%\Programs\openspec.

Download verifizieren

Um zu überprüfen, ob eine Datei vom OpenSpec-Release-Workflow erstellt wurde, führen Sie dies mit der GitHub CLI aus:

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

Es schlägt fehl, wenn der Workflow die Datei nicht erstellt hat. Der Installationsbefehl überprüft bereits jeden Download anhand der SHA256SUMS des Releases, daher ist dieser Schritt optional.

Von npm zur Standalone-Installation wechseln

Der Wechsel ist optional; npm funktioniert weiterhin. Ihre Einstellungen und Ihre Projekte werden übernommen; nur das Programm ändert sich.

1. Installieren Sie die Standalone-Kopie. In Ihrem Terminal:

openspec install

Es installiert das Standalone-openspec und gibt den Befehl aus, der Ihre npm- oder Homebrew-Kopie entfernt.

2. Entfernen Sie die alte Kopie. Sie steht normalerweise zuerst in Ihrem PATH, daher läuft sie weiterhin stattdessen, bis sie entfernt ist. Führen Sie den Befehl aus, den Schritt 1 ausgegeben hat, zum Beispiel:

npm uninstall -g @fission-ai/openspec

3. Prüfen Sie, welche Kopie ausgeführt wird. Öffnen Sie ein neues Terminal:

openspec version

Es sollte OpenSpec <version> (standalone) ausgeben. Wenn es stattdessen einen Paketmanager nennt, befindet sich noch eine andere Kopie in Ihrem PATH: which -a openspec (Windows: where.exe openspec) listet jede Kopie auf, entfernen Sie also die anderen.

Kein Projekt muss neu initialisiert werden. Um zurückzuwechseln, löschen Sie die Datei und führen Sie die npm-Installation erneut aus.

Aktualisierung

In Ihrem Terminal, in jedem Projekt, in dem Sie init ausgeführt haben:

openspec update

Wenn eine neuere CLI verfügbar ist, teilt openspec update dies mit und kann sie für Sie installieren; dieses Upgrade erfolgt einmal pro Rechner. Jeder Lauf aktualisiert die generierten Skills und Befehle des Projekts, die sich niemals selbst aktualisieren. Ein aktuelles Projekt gibt ✓ All 2 tool(s) up to date (v1.7.0) aus.

WARNING

Bei der Standalone-Installation führen Sie openspec install aus, um Ihre Kopie an Ort und Stelle zu ersetzen; openspec update teilt Ihnen mit, wenn eine neuere verfügbar ist. Bei Homebrew führen Sie brew upgrade openspec aus. Bei Deno führen Sie die Deno-Installation mit -f erneut aus; ohne diese Option überschreibt sie den installierten Befehl nicht. Bei Nix verwenden Sie nix profile upgrade openspec.

NOTE

Eine globale npm-Installation gehört zu einer Node-Installation. Wenn Sie mit nvm die Node-Version wechseln, kommt der openspec-Befehl nicht mit, installieren Sie ihn also unter der neuen Version erneut.

Deinstallation

Um OpenSpec zu deinstallieren, gehen Sie die folgenden Schritte durch; keiner davon berührt Ihren Quellcode. Sie können Ihren Agenten auch auf diesen Abschnitt verweisen und ihn die Entfernung durchführen lassen.

1. Entfernen Sie Shell-Vervollständigungen, falls Sie sie eingerichtet haben, während die CLI dies noch tun kann. In Ihrem Terminal:

openspec completion uninstall

2. Entfernen Sie die CLI. Bei der Standalone-Installation löschen Sie ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec, und diesen Ordner aus Ihrem Benutzer-PATH). Bei npm, in Ihrem Terminal:

npm uninstall -g @fission-ai/openspec

Bei Homebrew: brew uninstall openspec. Bei Deno: deno uninstall --global openspec. Bei Nix: nix profile remove openspec. Ihre Shell sollte openspec nicht mehr finden.

3. Löschen Sie, was übrig bleibt, oder behalten Sie es.

• Generierte Agenten-Dateien: openspec-*-Skills und opsx-Befehle unter Verzeichnissen wie .claude/ oder .agents/, pro Projekt. Unterstützte Tools listet die Pfade jedes Tools auf; MiniMax Code speichert Skills in ~/.minimax/skills.
• Reste aus älteren Versionen: Marker-Blöcke in CLAUDE.md oder AGENTS.md (Block löschen, Datei behalten) und opsx-*.md-Prompts in ~/.codex/prompts.
• Der openspec/-Ordner: pausieren Sie zuerst. specs/ und changes/archive/ sind Ihre Aufzeichnung des Systems, einfaches Markdown, das auch ohne OpenSpec gut lesbar ist.
• Rechnerbezogener Zustand: Einstellungen und die Telemetrie-ID in ~/.config/openspec/; Schema-Überschreibungen, Store-Registrierungen und die eingebauten Schemas der Standalone-Installation (binary-schemas/) in ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Registrierungen sind Zeiger; die Store-Repositories, auf die sie verweisen, bleiben unberührt.