Instalacja

Zainstaluj CLI openspec na swoim komputerze, zaktualizuj je i odinstaluj.

Instalacja

Na macOS lub Linux, w terminalu:

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

W systemie Windows, w PowerShell:

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

Jeśli instalator wypisze linię export PATH=..., uruchom ją. Następnie sprawdź, czy zadziałało.

Instalacja z asystentem AI

Wklej to do czatu AI:

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

Lub w terminalu przekaż je do agenta CLI (pokazano Claude Code):

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

To pobiera install.md z katalogu głównego repozytorium, czyli prompt napisany dla każdego agenta, który może uruchamiać polecenia powłoki (kilka integracji IDE nie może). Oczekuj, że Twój asystent:

1. Pominie instalację, jeśli CLI już jest na Twoim komputerze, i zaproponuje aktualizację w sposób, w jaki zostało zainstalowane. Jeśli to było npm lub Homebrew, wspomnij raz, że openspec install przełącza na instalację samodzielną, bez naciskania na to. W przeciwnym razie pokaże powyższe polecenie instalacji i poczeka na Twoje potwierdzenie przed jego uruchomieniem.
2. Użyje npm tylko wtedy, gdy o to poprosisz lub instalator zawiedzie, i zatrzyma się, jeśli Twoje Node jest starsze niż 22.12.0.
3. Zweryfikuje, że openspec jest w Twojej zmiennej PATH.
4. Nazwie folder, który jego zdaniem masz na myśli, zasugeruje narzędzie AI, z którym już rozmawiasz, i zapyta, których innych używasz, a następnie uruchomi tam openspec init (krok konfiguracji projektu).
5. Zgłosi, co utworzył init, i dokładną pisownię, aby wywołać OpenSpec w Twoim narzędziu.

Zatrzymuje się przed czymkolwiek wymagającym uprawnień i nigdy nie edytuje plików startowych Twojej powłoki. Polecenie instalacji powyżej i menedżery pakietów poniżej są źródłem prawdy, a prompt uruchamia je za Ciebie.

Ta metoda instalacji jest nowa i może dawać różne wyniki w zależności od użytego modelu. Używaj jej tylko wtedy, gdy czujesz się komfortowo poprawiając błędy AI. W przeciwnym razie zalecamy skorzystanie ze standardowej metody poniżej.

Menedżery pakietów

Instalują one OpenSpec jako pakiet Node.js, więc wymagają Node.js 22.12.0 lub nowszego (Homebrew i Nix dostarczają własne). W terminalu:

node --version

Jeśli to wypisze v22.12.0 lub wyżej, zainstaluj przez npm:

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

Jeśli nie, zainstaluj nowsze Node z nodejs.org lub przez menedżer wersji (nvm, fnm, asdf, volta), albo użyj instalacji samodzielnej.

Homebrew

Homebrew instaluje OpenSpec i jego zależność Node.js na macOS lub Linux. W terminalu:

brew install openspec

Formuła jest opublikowana w homebrew-core, więc nie musisz dodawać tapa.

Yarn

yarn global add działa tylko w Yarn Classic (1.x). Nowoczesny Yarn usunął instalacje globalne, więc użyj npm, pnpm lub bun. Globalne CLI nie musi współdzielić menedżera pakietów Twojego projektu.

Bun

Bun instaluje OpenSpec, ale go nie uruchamia, więc nadal potrzebujesz Node na swoim komputerze (zobacz Menedżery pakietów). Bez niego każde polecenie kończy się błędem env: node: No such file or directory. Bun traktuje każde CLI Node w ten sposób.

Deno

Deno instaluje CLI z npm i wymaga jawnych flag uprawnień. W terminalu:

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

Niektóre polecenia uruchamiają inny program: openspec config edit otwiera Twój edytor. Deno przerywa je promptem o uprawnieniach przy każdym uruchomieniu. Aby przestało pytać, dodaj zakresowe --allow-run=<program> do polecenia instalacji.

NOTE

Jeśli Deno nie może rozwiązać @latest, przypisz zakres wersji: npm:@fission-ai/openspec@^1.7.0.

Nix

Repozytorium OpenSpec zawiera flake Nix. Zainstaluj go do swojego profilu. W terminalu:

nix profile install github:Fission-AI/OpenSpec

Lub najpierw uruchom jednorazowe polecenie, bez instalowania:

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

To nie pozostawia niczego w Twojej zmiennej PATH, więc nie ma później czego sprawdzać.

Aby zamiast tego umieścić OpenSpec w powłoce deweloperskiej projektu, dodaj flake jako wejście i użyj jego domyślnego pakietu; flake.nix wymienia wyjścia.

Pakiet Nix zawiera skrypty dopełnień dla Bash, Fish i Zsh w standardowych lokalizacjach (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), więc ładują się wraz z pakietem i nie ma potrzeby uruchamiania openspec completion install.

Sprawdź, czy zadziałało

Niezależnie od użytej metody, w terminalu:

openspec --version

Jeśli to wypisze numer wersji, CLI jest w Twojej zmiennej PATH. Instaluje się raz na komputer.

Następnie skonfiguruj swój projekt. Jeśli Twój asystent już uruchomił init, ta strona pokazuje, co zapisał i jak to dostosować.

Opcje instalacji

Aby wybrać wersję lub folder, ustaw zmienną przed sh:

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

• OPENSPEC_VERSION: wydanie do zainstalowania, np. v1.15.0. Domyślnie jest to najnowsze wydanie.
• OPENSPEC_INSTALL_DIR: folder do zainstalowania. Domyślnie ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

W systemie Windows najpierw ustaw zmienną:

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

W Alpine Linux uruchom apk add libstdc++ libgcc przed instalacją.

Pobieranie ręczne

Każde wydanie ma jeden plik na komputer:

Komputer	Plik
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. Pobierz swój plik z najnowszego wydania. Pliki są dołączane kilka minut po opublikowaniu wydania. Jeśli Twojego jeszcze nie ma, poczekaj i odśwież, albo pobierz z poprzedniego wydania.
2. Rozpakuj go. W terminalu: tar -xzf openspec-darwin-arm64.tar.gz. W systemie Windows kliknij prawym przyciskiem myszy .zip i wybierz „Wyodrębnij wszystko”.
3. Na macOS uruchom xattr -d com.apple.quarantine openspec w folderze, do którego rozpakowałeś. macOS blokuje pliki pobrane w przeglądarce, dopóki tego nie zrobisz.
4. Przenieś openspec do folderu w swojej zmiennej PATH, np. ~/.local/bin. W systemie Windows przenieś openspec.exe do folderu w swojej zmiennej PATH użytkownika, np. %LOCALAPPDATA%\Programs\openspec.

Weryfikacja pobrania

Aby sprawdzić, że plik został zbudowany przez proces wydawniczy OpenSpec, uruchom to z GitHub CLI:

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

Polecenie kończy się niepowodzeniem, jeśli proces nie zbudował pliku. Polecenie instalacji już sprawdza każde pobranie względem SHA256SUMS wydania, więc ten krok jest opcjonalny.

Przejście z npm na instalację samodzielną

Przejście jest opcjonalne; npm nadal działa. Twoje ustawienia i projekty przenoszą się; zmienia się tylko program.

1. Zainstaluj kopię samodzielną. W terminalu:

openspec install

Instaluje samodzielne openspec i wypisuje polecenie usuwające Twoją kopię npm lub Homebrew.

2. Usuń starą kopię. Zwykle jest pierwsza w Twojej zmiennej PATH, więc dopóki nie zniknie, to ona będzie uruchamiana. Uruchom polecenie wypisane w kroku 1, na przykład:

npm uninstall -g @fission-ai/openspec

3. Sprawdź, która kopia działa. Otwórz nowy terminal:

openspec version

Powinno wypisać OpenSpec <wersja> (standalone). Jeśli zamiast tego podaje menedżer pakietów, inna kopia nadal jest w Twojej zmiennej PATH: which -a openspec (Windows: where.exe openspec) wymienia wszystkie kopie, więc usuń pozostałe.

Żaden projekt nie wymaga ponownej inicjalizacji. Aby wrócić, usuń plik i uruchom ponownie instalację npm.

Aktualizacja

W terminalu, w każdym projekcie, w którym uruchomiłeś init:

openspec update

Gdy dostępne jest nowsze CLI, openspec update to zgłasza i może je zainstalować za Ciebie; ta aktualizacja odbywa się raz na komputer. Każde uruchomienie odświeża wygenerowane umiejętności i polecenia projektu, które nigdy nie aktualizują się same. Aktualny projekt wypisuje ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Przy instalacji samodzielnej uruchom openspec install, aby zastąpić swoją kopię w miejscu; openspec update informuje Cię, gdy dostępna jest nowsza. W Homebrew uruchom brew upgrade openspec. W Deno uruchom ponownie instalację Deno z -f; bez tego nie nadpisze zainstalowanego polecenia. W Nix użyj nix profile upgrade openspec.

NOTE

Globalna instalacja npm należy do jednej instalacji Node. Przełącz wersje Node za pomocą nvm, a polecenie openspec nie przeniesie się, więc zainstaluj je ponownie w nowej wersji.

Odinstalowanie

Aby odinstalować OpenSpec, przejdź przez poniższe kroki; żaden z nich nie dotyka Twojego kodu źródłowego. Możesz też wskazać swojemu agentowi tę sekcję i pozwolić mu zająć się usunięciem.

1. Usuń dopełnienia powłoki, jeśli je skonfigurowałeś, dopóki CLI jeszcze może to zrobić. W terminalu:

openspec completion uninstall

2. Usuń CLI. W przypadku instalacji samodzielnej usuń ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec i ten folder ze swojej zmiennej PATH użytkownika). W przypadku npm, w terminalu:

npm uninstall -g @fission-ai/openspec

W Homebrew: brew uninstall openspec. W Deno: deno uninstall --global openspec. W Nix: nix profile remove openspec. Twoja powłoka nie powinna już znajdować openspec.

3. Usuń to, co zostało, albo zachowaj.

• Wygenerowane pliki agenta: umiejętności openspec-* i polecenia opsx w katalogach takich jak .claude/ lub .agents/, dla każdego projektu. Obsługiwane narzędzia wymienia ścieżki każdego narzędzia; MiniMax Code przechowuje umiejętności w ~/.minimax/skills.
• Pozostałości po starszych wersjach: bloki znaczników w CLAUDE.md lub AGENTS.md (usuń blok, zachowaj plik) i prompty opsx-*.md w ~/.codex/prompts.
• Folder openspec/: najpierw się zatrzymaj. specs/ i changes/archive/ to Twój zapis systemu, zwykły Markdown, który dobrze czyta się bez OpenSpec.
• Stan na komputer: ustawienia i identyfikator telemetrii w ~/.config/openspec/; nadpisania schematów, rejestracje magazynów i wbudowane schematy instalacji samodzielnej (binary-schemas/) w ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Rejestracje to wskaźniki; repozytoria magazynów, na które wskazują, pozostają nietknięte.