Installation

Prerequisites

Node.js 20.19.0 or higher — Check your version: node --version

Package Managers

npm

bash

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

pnpm

bash

pnpm add -g @fission-ai/openspec@latest

yarn

bash

yarn global add @fission-ai/openspec@latest

bun

bash

bun add -g @fission-ai/openspec@latest

Nix

Run OpenSpec directly without installation:

bash

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

Or install to your profile:

bash

nix profile install github:Fission-AI/OpenSpec

Or add to your development environment in flake.nix:

nix

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    openspec.url = "github:Fission-AI/OpenSpec";
  };

  outputs = { nixpkgs, openspec, ... }: {
    devShells.x86_64-linux.default = nixpkgs.legacyPackages.x86_64-linux.mkShell {
      buildInputs = [ openspec.packages.x86_64-linux.default ];
    };
  };
}

Verify Installation

bash

openspec --version

Next Steps

After installing, initialize OpenSpec in your project:

bash

cd your-project
openspec init

See Getting Started for a full walkthrough.