Installazione

Installa il CLI openspec sulla tua macchina, aggiornalo e disinstallalo.

Installa

Su macOS o Linux, nel tuo terminale:

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

Su Windows, in PowerShell:

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

Se l'installatore stampa una riga export PATH=..., eseguila. Poi verifica che funzioni.

Installa con il tuo assistente AI

Incolla questo nella chat con la tua AI:

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

Oppure, nel tuo terminale, instradalo a un agente CLI (mostrato Claude Code):

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

Questo recupera install.md alla radice del repository, un prompt scritto per qualsiasi agente in grado di eseguire comandi shell (alcune integrazioni IDE non lo sono). Attendi che il tuo assistente:

1. Salta l'installazione se il CLI è già sulla tua macchina, e proponi di aggiornarlo nel modo in cui è stato installato. Se è stato npm o Homebrew, menziona una volta che openspec install passa all'installazione standalone, senza insistere. Altrimenti, mostrati il comando di installazione sopra e attendi la tua conferma prima di eseguirlo.
2. Usi npm solo se lo richiedi o se l'installatore fallisce, e si fermi se il tuo Node è più vecchio di 22.12.0.
3. Verifichi che openspec sia nel tuo PATH.
4. Nomini la cartella che pensa tu intenda, suggerisca lo strumento AI con cui stai già parlando e chieda quali altri usi, poi esegua openspec init lì (il passaggio di configurazione del progetto).
5. Riporti ciò che init ha creato e l'ortografia esatta per invocare OpenSpec nel tuo strumento.

Si ferma prima di qualsiasi operazione privilegiata e non modifica mai i file di avvio della shell. Il comando di installazione sopra e i gestori di pacchetti qui sotto sono la fonte attendibile, e il prompt li esegue per te.

Questo metodo di installazione è nuovo e può dare risultati variabili a seconda del modello utilizzato. Usalo solo se ti senti a tuo agio nel correggere gli errori dell'AI. Altrimenti consigliamo di seguire il metodo standard qui sotto.

Gestori di pacchetti

Questi installano OpenSpec come pacchetto Node.js, quindi richiedono Node.js 22.12.0 o successivo (Homebrew e Nix portano il proprio). Nel tuo terminale:

node --version

Se stampa v22.12.0 o superiore, installa con npm:

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

In caso contrario, installa un Node più recente da nodejs.org o tramite il tuo gestore di versioni (nvm, fnm, asdf, volta), oppure usa l'installazione standalone.

Homebrew

Homebrew installa OpenSpec e la sua dipendenza Node.js su macOS o Linux. Nel tuo terminale:

brew install openspec

La formula è pubblicata in homebrew-core, quindi non è necessario aggiungere un tap.

Yarn

yarn global add funziona solo con Yarn Classic (1.x). Yarn moderno ha rimosso le installazioni globali, quindi usa npm, pnpm o bun al posto. Un CLI globale non deve condividere il gestore di pacchetti del tuo progetto.

Bun

Bun installa OpenSpec ma non lo esegue, quindi hai ancora bisogno di Node sulla tua macchina (vedi Gestori di pacchetti). Senza di esso, ogni comando fallisce con env: node: No such file or directory. Bun tratta ogni CLI Node in questo modo.

Deno

Deno installa il CLI da npm e richiede flag di permesso espliciti. Nel tuo terminale:

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

Alcuni comandi avviano un altro programma: openspec config edit apre il tuo editor. Deno li interrompe con un prompt di permesso a ogni esecuzione. Per fare in modo che non lo chieda, aggiungi un --allow-run=<program> limitato al comando di installazione.

NOTE

Se Deno non riesce a risolvere @latest, fissa un intervallo di versione: npm:@fission-ai/openspec@^1.7.0.

Nix

Il repository OpenSpec include un flake Nix. Installalo nel tuo profilo. Nel tuo terminale:

nix profile install github:Fission-AI/OpenSpec

Oppure esegui prima un comando singolo, senza installare:

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

Questo non lascia nulla nel tuo PATH, quindi non c'è un'installazione da verificare successivamente.

Per inserire OpenSpec in un dev shell di progetto, aggiungi il flake come input e usa il suo pacchetto predefinito; flake.nix elenca gli output.

Il pacchetto Nix include gli script di completamento per Bash, Fish e Zsh nelle posizioni standard (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), quindi vengono caricati con il pacchetto e non è necessario eseguire openspec completion install.

Verifica che funzioni

Qualunque metodo tu abbia usato, nel tuo terminale:

openspec --version

Se stampa un numero di versione, il CLI è nel tuo PATH. Si installa una volta per macchina.

Poi, configura il tuo progetto. Se il tuo assistente ha già eseguito init, quella pagina mostra ciò che ha scritto e come adattarlo.

Opzioni di installazione

Per scegliere una versione o una cartella, imposta una variabile prima di sh:

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

• OPENSPEC_VERSION: la release da installare, ad esempio v1.15.0. Il valore predefinito è la release più recente.
• OPENSPEC_INSTALL_DIR: la cartella di installazione. Il valore predefinito è ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

Su Windows, imposta prima la variabile:

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

Su Alpine Linux, esegui apk add libstdc++ libgcc prima dell'installazione.

Scarica manualmente

Ogni release ha un file per computer:

Computer	File
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. Scarica il tuo file dalla release più recente. I file vengono allegati pochi minuti dopo la pubblicazione di una release. Se il tuo non è ancora elencato, attendi e ricarica, oppure prendilo dalla release precedente.
2. Decomprimi il file. Nel tuo terminale: tar -xzf openspec-darwin-arm64.tar.gz. Su Windows, fai clic destro sul file .zip e scegli Estrai tutto.
3. Su macOS, esegui xattr -d com.apple.quarantine openspec nella cartella in cui hai decompresso. macOS blocca i file scaricati in un browser finché non lo fai.
4. Sposta openspec in una cartella nel tuo PATH, ad esempio ~/.local/bin. Su Windows, sposta openspec.exe in una cartella nel tuo PATH utente, ad esempio %LOCALAPPDATA%\Programs\openspec.

Verifica un download

Per verificare che un file sia stato costruito dal workflow di release di OpenSpec, esegui questo con la GitHub CLI:

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

Fallisce se il workflow non ha costruito il file. Il comando di installazione verifica già ogni download rispetto al SHA256SUMS della release, quindi questo passaggio è opzionale.

Passa da npm all'installazione standalone

Il passaggio è opzionale; npm continua a funzionare. Le tue impostazioni e i tuoi progetti vengono mantenuti; cambia solo il programma.

1. Installa la copia standalone. Nel tuo terminale:

openspec install

Installa la copia standalone di openspec e stampa il comando che rimuove la tua copia npm o Homebrew.

2. Rimuovi la vecchia copia. Di solito viene prima nel tuo PATH, quindi finché non viene eliminata continua a funzionare al suo posto. Esegui il comando stampato al passaggio 1, ad esempio:

npm uninstall -g @fission-ai/openspec

3. Verifica quale copia viene eseguita. Apri un nuovo terminale:

openspec version

Dovrebbe stampare OpenSpec <version> (standalone). Se indica un gestore di pacchetti al suo posto, un'altra copia è ancora nel tuo PATH: which -a openspec (Windows: where.exe openspec) elenca tutte le copie, quindi rimuovi le altre.

Nessun progetto necessita di re-inizializzazione. Per tornare indietro, elimina il file ed esegui nuovamente l'installazione npm.

Aggiornamento

Nel tuo terminale, in ogni progetto in cui hai eseguito init:

openspec update

Quando esiste un CLI più recente, openspec update lo segnala e può installarlo per te; quell'aggiornamento è una volta per macchina. Ogni esecuzione aggiorna le skill e i comandi generati del progetto, che non si aggiornano mai da soli. Un progetto aggiornato stampa ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Con l'installazione standalone, esegui openspec install per sostituire la tua copia sul posto; openspec update ti avvisa quando ce n'è una più recente. Su Homebrew, esegui brew upgrade openspec. Su Deno, esegui nuovamente l'installazione Deno con -f; senza di esso non sovrascriverà il comando installato. Su Nix, usa nix profile upgrade openspec.

NOTE

Un'installazione globale npm appartiene a una singola installazione di Node. Cambiando versione di Node con nvm, il comando openspec non viene portato con te, quindi installalo nuovamente sotto la nuova versione.

Disinstallazione

Per disinstallare OpenSpec, segui i passaggi qui sotto; nessuno di essi tocca il tuo codice sorgente. Puoi anche indicare questa sezione al tuo agente e lasciare che gestisca la rimozione.

1. Rimuovi i completamenti shell, se li hai configurati, mentre il CLI può ancora farlo. Nel tuo terminale:

openspec completion uninstall

2. Rimuovi il CLI. Per l'installazione standalone, elimina ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec, e quella cartella dal tuo PATH utente). Per npm, nel tuo terminale:

npm uninstall -g @fission-ai/openspec

Su Homebrew: brew uninstall openspec. Su Deno: deno uninstall --global openspec. Su Nix: nix profile remove openspec. La tua shell non dovrebbe più trovare openspec.

3. Elimina ciò che resta, oppure mantienilo.

• File dell'agente generati: skill openspec-* e comandi opsx nelle directory come .claude/ o .agents/, per progetto. Strumenti supportati elenca i percorsi di ogni strumento; MiniMax Code conserva le skill in ~/.minimax/skills.
• Residui di versioni precedenti: blocchi di marcatori in CLAUDE.md o AGENTS.md (elimina il blocco, mantieni il file) e prompt opsx-*.md in ~/.codex/prompts.
• La cartella openspec/: fermati prima. specs/ e changes/archive/ sono il tuo registro del sistema, Markdown semplice che si legge bene senza OpenSpec.
• Stato per macchina: impostazioni e id di telemetria in ~/.config/openspec/; override di schema, registrazioni di store e gli schema integrati dell'installazione standalone (binary-schemas/) in ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Le registrazioni sono puntatori; i repository store a cui puntano non vengono toccati.