Instalación

Instala la CLI de openspec en tu máquina, actualízala y desinstálala.

Instalar

En macOS o Linux, en tu terminal:

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

En Windows, en PowerShell:

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

Si el instalador imprime una línea export PATH=..., ejecútala. Luego verifica que funcionó.

Instalar con tu asistente de IA

Pega esto en tu chat de IA:

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

O, en tu terminal, redirígelo a un agente CLI (se muestra Claude Code):

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

Eso descarga install.md en la raíz del repositorio, un prompt escrito para cualquier agente que pueda ejecutar comandos shell (algunas integraciones de IDE no pueden). Espera que tu asistente:

1. Omita la instalación si la CLI ya está en tu máquina, y ofrece actualizarla de la forma en que fue instalada. Si fue con npm o Homebrew, menciona una vez que openspec install cambia a la instalación independiente, sin insistir. De lo contrario, te muestre el comando de instalación anterior y espere tu confirmación antes de ejecutarlo.
2. Use npm solo si lo pides o si el instalador falla, y se detenga si tu Node es anterior a 22.12.0.
3. Verifique que openspec esté en tu PATH.
4. Nombre la carpeta que cree que quieres, sugiera la herramienta de IA con la que ya estás hablando, pregunte qué otras usas, y luego ejecute openspec init allí (el paso de configuración del proyecto).
5. Informe lo que init creó y la forma exacta de invocar OpenSpec en tu herramienta.

Se detiene antes de cualquier acción privilegiada y nunca edita tus archivos de inicio de shell. El comando de instalación anterior y los gestores de paquetes a continuación son la fuente de verdad, y el prompt los ejecuta por ti.

Este método de instalación es nuevo y puede dar resultados variables según el modelo utilizado. Úsalo solo si te sientes cómodo corrigiendo errores de la IA. De lo contrario, recomendamos seguir el método estándar a continuación.

Gestores de paquetes

Estos instalan OpenSpec como un paquete de Node.js, por lo que necesitan Node.js 22.12.0 o superior (Homebrew y Nix traen el suyo propio). En tu terminal:

node --version

Si eso imprime v22.12.0 o superior, instala con npm:

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

Si no, instala una versión más reciente de Node desde nodejs.org o mediante tu gestor de versiones (nvm, fnm, asdf, volta), o usa la instalación independiente en su lugar.

Homebrew

Homebrew instala OpenSpec y su dependencia Node.js en macOS o Linux. En tu terminal:

brew install openspec

La fórmula se publica en homebrew-core, por lo que no necesitas agregar un tap.

Yarn

yarn global add es solo para Yarn Classic (1.x). Yarn moderno eliminó las instalaciones globales, así que usa npm, pnpm o bun en su lugar. Una CLI global no tiene que compartir el gestor de paquetes de tu proyecto.

Bun

Bun instala OpenSpec pero no lo ejecuta, por lo que aún necesitas Node en tu máquina (ver Gestores de paquetes). Sin él, cada comando falla con env: node: No such file or directory. Bun trata cada CLI de Node de esta manera.

Deno

Deno instala la CLI desde npm y necesita indicadores de permisos explícitos. En tu terminal:

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

Algunos comandos lanzan otro programa: openspec config edit abre tu editor. Deno interrumpe esos con un aviso de permiso en cada ejecución. Para evitar que lo pregunte, agrega un --allow-run=<programa> acotado al comando de instalación.

NOTE

Si Deno no puede resolver @latest, fija un rango de versión en su lugar: npm:@fission-ai/openspec@^1.7.0.

Nix

El repositorio de OpenSpec incluye un flake de Nix. Instálalo en tu perfil. En tu terminal:

nix profile install github:Fission-AI/OpenSpec

O ejecuta un comando único primero, sin instalar:

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

Eso no deja nada en tu PATH, por lo que no hay una instalación que verificar después.

Para poner OpenSpec en un dev shell de proyecto en su lugar, agrega el flake como input y usa su paquete por defecto; flake.nix enumera los outputs.

El paquete de Nix incluye los scripts de completado de Bash, Fish y Zsh en las ubicaciones estándar (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), por lo que se cargan con el paquete y no hay necesidad de ejecutar openspec completion install.

Verifica que funcionó

Sea cual sea el método que usaste, en tu terminal:

openspec --version

Si eso imprime un número de versión, la CLI está en tu PATH. Se instala una vez por máquina.

A continuación, configura tu proyecto. Si tu asistente ya ejecutó init, esa página muestra lo que escribió y cómo ajustarlo.

Opciones de instalación

Para elegir una versión o una carpeta, establece una variable antes de sh:

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

• OPENSPEC_VERSION: la versión a instalar, como v1.15.0. El valor predeterminado es la versión más reciente.
• OPENSPEC_INSTALL_DIR: la carpeta donde instalar. El valor predeterminado es ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

En Windows, establece la variable primero:

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

En Alpine Linux, ejecuta apk add libstdc++ libgcc antes de instalar.

Descarga manual

Cada versión tiene un archivo por computadora:

Computadora	Archivo
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. Descarga tu archivo desde la última versión. Los archivos se adjuntan unos minutos después de que se publica una versión. Si el tuyo aún no aparece, espera y recarga, o tómalos de la versión anterior.
2. Descomprime el archivo. En tu terminal: tar -xzf openspec-darwin-arm64.tar.gz. En Windows, haz clic derecho en el .zip y elige Extraer todo.
3. En macOS, ejecuta xattr -d com.apple.quarantine openspec en la carpeta donde descomprimiste. macOS bloquea los archivos descargados en un navegador hasta que lo hagas.
4. Mueve openspec a una carpeta en tu PATH, como ~/.local/bin. En Windows, mueve openspec.exe a una carpeta en tu PATH de usuario, como %LOCALAPPDATA%\Programs\openspec.

Verificar una descarga

Para comprobar que un archivo fue compilado por el flujo de trabajo de versiones de OpenSpec, ejecuta esto con la CLI de GitHub:

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

Falla si el flujo de trabajo no compiló el archivo. El comando de instalación ya verifica cada descarga contra los SHA256SUMS de la versión, por lo que este paso es opcional.

Cambiar de npm a la instalación independiente

Cambiar es opcional; npm sigue funcionando. Tu configuración y tus proyectos se conservan; solo cambia el programa.

1. Instala la copia independiente. En tu terminal:

openspec install

Instala el openspec independiente e imprime el comando que elimina tu copia de npm o Homebrew.

2. Elimina la copia anterior. Normalmente aparece primero en tu PATH, por lo que hasta que no se elimine seguirá ejecutándose en su lugar. Ejecuta el comando que el paso 1 imprimió, por ejemplo:

npm uninstall -g @fission-ai/openspec

3. Verifica qué copia se ejecuta. Abre una nueva terminal:

openspec version

Debería imprimir OpenSpec <version> (standalone). Si nombra un gestor de paquetes en su lugar, hay otra copia en tu PATH: which -a openspec (Windows: where.exe openspec) enumera todas las copias, así que elimina las demás.

Ningún proyecto necesita reinicializarse. Para volver, elimina el archivo y ejecuta la instalación de npm nuevamente.

Actualizar

En tu terminal, en cada proyecto donde ejecutaste init:

openspec update

Cuando hay una CLI más reciente, openspec update lo indica y puede instalarla por ti; esa actualización es una vez por máquina. Cada ejecución actualiza las skills y comandos generados del proyecto, que nunca se actualizan por sí solos. Un proyecto actualizado imprime ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Con la instalación independiente, ejecuta openspec install para reemplazar tu copia en el lugar; openspec update te avisa cuando hay una más reciente. En Homebrew, ejecuta brew upgrade openspec. En Deno, vuelve a ejecutar la instalación de Deno con -f; no sobrescribirá el comando instalado sin él. En Nix, usa nix profile upgrade openspec.

NOTE

Una instalación global de npm pertenece a una instalación de Node. Si cambias de versión de Node con nvm, el comando openspec no se traslada, así que instálalo nuevamente bajo la nueva versión.

Desinstalar

Para desinstalar OpenSpec, sigue los pasos a continuación; ninguno de ellos toca tu código fuente. También puedes indicarle a tu agente esta sección y dejar que se encargue de la eliminación.

1. Elimina los completados de shell, si los configuraste, mientras la CLI aún puede hacerlo. En tu terminal:

openspec completion uninstall

2. Elimina la CLI. Para la instalación independiente, elimina ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec, y esa carpeta de tu PATH de usuario). Para npm, en tu terminal:

npm uninstall -g @fission-ai/openspec

En Homebrew: brew uninstall openspec. En Deno: deno uninstall --global openspec. En Nix: nix profile remove openspec. Tu shell ya no debería encontrar openspec.

3. Elimina lo que queda o consérvalo.

• Archivos de agente generados: skills openspec-* y comandos opsx en directorios como .claude/ o .agents/, por proyecto. Herramientas compatibles enumera las rutas de cada herramienta; MiniMax Code guarda las skills en ~/.minimax/skills.
• Restos de versiones anteriores: bloques de marcador en CLAUDE.md o AGENTS.md (elimina el bloque, conserva el archivo) y prompts opsx-*.md en ~/.codex/prompts.
• La carpeta openspec/: piénsalo primero. specs/ y changes/archive/ son tu registro del sistema, Markdown simple que se lee bien sin OpenSpec.
• Estado por máquina: configuración y el id de telemetría en ~/.config/openspec/; anulaciones de esquema, registros de stores y los esquemas integrados de la instalación independiente (binary-schemas/) en ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Los registros son punteros; los repositorios de stores a los que apuntan no se tocan.