インストール

マシンに openspec CLI をインストール、更新、アンインストールする方法。

インストール

macOS または Linux では、ターミナルで次を実行します。

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

Windows では、PowerShell で次を実行します。

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

インストーラーが export PATH=... の行を表示した場合は、それを実行してください。その後 動作確認 を行います。

AI アシスタントと一緒にインストール

次の内容を AI チャットに貼り付けます。

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

または、ターミナルで CLI エージェントにパイプします（Claude Code の場合）。

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

これにより install.md（リポジトリルート） を取得します。これはシェルコマンドを実行できるあらゆるエージェント向けに書かれたプロンプトです（一部の IDE 統合では実行できません）。アシスタントは次の処理を行うことが想定されています。

1. CLI が既にマシンに存在する場合はインストールをスキップし、元のインストール方法での更新を提案します。npm または Homebrew でインストールしていた場合は、openspec install がスタンドアロンインストールに切り替わることを一度だけ言及し、強く推奨はしません。それ以外の場合は、上記のインストールコマンドを表示し、実行前に確認を待ちます。
2. ユーザーが求めた場合、またはインストーラーが失敗した場合にのみ npm を使用し、Node が 22.12.0 より古い場合は停止します。
3. openspec が PATH 上にあることを確認します。
4. 対象のフォルダ名を提示し、現在使用している AI ツールを提案し、他に使用しているツールを尋ねた後、そのフォルダで openspec init を実行します（プロジェクト設定 のステップ）。
5. init が作成したものと、ツールで OpenSpec を起動するための正確なコマンドを報告します。

特権が必要な操作の前で停止し、シェルのスタートアップファイルは決して編集しません。上記のインストールコマンド と 以下のパッケージマネージャー が正式な情報源であり、プロンプトはそれらを代わりに実行します。

このインストール方法は新しく、使用するモデルによって結果が異なる場合があります。AI の誤りを修正できる場合にのみ使用してください。それ以外の場合は、以下の標準手順に従うことをお勧めします。

パッケージマネージャー

これらは OpenSpec を Node.js パッケージとしてインストールするため、Node.js 22.12.0 以降が必要です（Homebrew と Nix は各自で Node.js を同梱します）。ターミナルで次を実行します。

node --version

v22.12.0 以上が表示された場合は、npm でインストールします。

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

表示されない場合は、nodejs.org またはバージョン管理ツール（nvm、fnm、asdf、volta）から新しい Node をインストールするか、代わりに スタンドアロンインストール を使用してください。

Homebrew

Homebrew は macOS または Linux に OpenSpec と Node.js 依存関係をインストールします。ターミナルで次を実行します。

brew install openspec

formula は homebrew-core で公開されているため、tap を追加する必要はありません。

Yarn

yarn global add は Yarn Classic（1.x）専用です。モダンな Yarn はグローバルインストールを削除したため、代わりに npm、pnpm、または bun を使用してください。グローバル CLI はプロジェクトのパッケージマネージャーと共有する必要はありません。

Bun

Bun は OpenSpec をインストールしますが実行はしないため、マシンに Node が必要です（パッケージマネージャー を参照）。Node がないと、すべてのコマンドが env: node: No such file or directory で失敗します。Bun は すべての Node CLI をこのように扱います。

Deno

Deno は npm から CLI をインストールし、明示的なパーミッションフラグが必要です。ターミナルで次を実行します。

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

一部のコマンドは別のプログラムを起動します：openspec config edit はエディターを開きます。Deno は実行のたびにパーミッションプロンプトでこれらを中断します。確認を停止するには、インストールコマンドにスコープ付きの --allow-run=<program> を追加してください。

NOTE

Deno が @latest を解決できない場合は、代わりにバージョン範囲を指定します： npm:@fission-ai/openspec@^1.7.0。

Nix

OpenSpec リポジトリは Nix flake を同梱しています。プロファイルにインストールします。ターミナルで次を実行します。

nix profile install github:Fission-AI/OpenSpec

または、インストールせずに一回限りのコマンドを実行します。

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

これは PATH に何も残さないため、後でインストールを確認する必要はありません。

プロジェクトの dev shell に OpenSpec を入れる場合は、flake を input として追加し、デフォルトパッケージを使用します。flake.nix に outputs が一覧表示されています。

Nix パッケージは Bash、Fish、Zsh の補完スクリプトを標準の場所（share/bash-completion/completions、share/fish/vendor_completions.d、share/zsh/site-functions）に同梱しているため、パッケージと一緒に読み込まれ、openspec completion install を実行する必要はありません。

動作確認

どの方法を使用した場合でも、ターミナルで次を実行します。

openspec --version

バージョン番号が表示されれば、CLI は PATH 上にあります。マシンごとに一度だけインストールされます。

次に、プロジェクトを設定 します。アシスタントが既に init を実行している場合は、そのページに書き込まれた内容と調整方法が表示されます。

インストールオプション

バージョンまたはフォルダを指定するには、sh の前に変数を設定します。

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

• OPENSPEC_VERSION：インストールするリリース。例：v1.15.0。デフォルトは最新のリリースです。
• OPENSPEC_INSTALL_DIR：インストール先フォルダ。デフォルトは ~/.local/bin（Windows：%LOCALAPPDATA%\Programs\openspec）。

Windows では、先に変数を設定します。

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

Alpine Linux では、インストール前に apk add libstdc++ libgcc を実行してください。

手動ダウンロード

各リリースにはコンピューターごとに 1 つのファイルがあります。

コンピューター	ファイル
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. 最新リリース からファイルをダウンロードします。ファイルはリリース公開の数分後に添付されます。自分のファイルがまだ表示されない場合は、待ってリロードするか、前のリリースから取得してください。
2. 展開します。ターミナルで：tar -xzf openspec-darwin-arm64.tar.gz。Windows では、.zip を右クリックして「すべて展開」を選択します。
3. macOS では、展開したフォルダで xattr -d com.apple.quarantine openspec を実行します。macOS は実行するまでブラウザでダウンロードしたファイルをブロックします。
4. openspec を PATH 上のフォルダ（例：~/.local/bin）に移動します。Windows では、openspec.exe をユーザー PATH 上のフォルダ（例：%LOCALAPPDATA%\Programs\openspec）に移動します。

ダウンロードの検証

ファイルが OpenSpec リリースワークフローによって構築されたことを確認するには、GitHub CLI で次を実行します。

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

ワークフローがファイルを構築していない場合に失敗します。インストールコマンドは既に各ダウンロードをリリースの SHA256SUMS に対して検証するため、このステップはオプションです。

npm からスタンドアロンインストールに切り替え

切り替えは任意です。npm は引き続き機能します。設定とプロジェクトは引き継がれ、プログラムだけが変わります。

1. スタンドアロン版をインストールします。 ターミナルで次を実行します。

openspec install

スタンドアロン版の openspec をインストールし、npm または Homebrew 版を削除するコマンドを表示します。

2. 古い版を削除します。 通常は PATH で先に見つかるため、削除されるまでそちらが実行され続けます。ステップ 1 で表示されたコマンドを実行します。例：

npm uninstall -g @fission-ai/openspec

3. どの版が実行されるか確認します。 新しいターミナルを開きます。

openspec version

OpenSpec <version> (standalone) と表示されるはずです。パッケージマネージャーの名前が表示される場合は、別の版がまだ PATH 上にあります：which -a openspec（Windows：where.exe openspec）ですべての版を一覧表示するので、他を削除してください。

プロジェクトの再初期化は不要です。元に戻すには、ファイルを削除して npm インストールを再実行してください。

更新

ターミナルで、init を実行した各プロジェクトで次を実行します。

openspec update

新しい CLI が利用可能になると、openspec update がその旨を伝え、インストールも行えます。このアップグレードはマシンごとに一度だけです。実行するたびに、プロジェクトの生成されたスキルとコマンドが更新されます。これらは自動的には更新されません。最新のプロジェクトでは ✓ All 2 tool(s) up to date (v1.7.0) と表示されます。

WARNING

スタンドアロンインストールでは、openspec install を実行してその場で版を置き換えます。openspec update は新しい版が利用可能になると通知します。Homebrew では brew upgrade openspec を実行します。Deno では、Deno インストール を -f 付きで再実行します。これがないとインストール済みのコマンドを上書きしません。Nix では nix profile upgrade openspec を使用します。

NOTE

グローバル npm インストールは 1 つの Node インストールに属します。nvm で Node バージョンを切り替えると openspec コマンドは引き継がれないため、新しいバージョンで再度インストールしてください。

アンインストール

OpenSpec をアンインストールするには、以下の手順を実行してください。ソースコードには一切影響しません。エージェントにこのセクションを指し示して、削除を任せることもできます。

1. シェル補完 を削除します（設定している場合）。CLI がまだ実行できる状態で行います。ターミナルで次を実行します。

openspec completion uninstall

2. CLI を削除します。 スタンドアロンインストールの場合は ~/.local/bin/openspec を削除します（Windows：%LOCALAPPDATA%\Programs\openspec およびユーザー PATH からそのフォルダを削除）。npm の場合は、ターミナルで次を実行します。

npm uninstall -g @fission-ai/openspec

Homebrew の場合：brew uninstall openspec。Deno の場合：deno uninstall --global openspec。Nix の場合：nix profile remove openspec。シェルが openspec を見つけられなくなります。

3. 残りを削除するか、保持します。

• 生成されたエージェントファイル：プロジェクトごとに .claude/ や .agents/ などのディレクトリ配下の openspec-* スキルと opsx コマンド。サポートツール に各ツールのパスが一覧表示されています。MiniMax Code は ~/.minimax/skills にスキルを保持します。
• 古いバージョンからの残骸：CLAUDE.md または AGENTS.md 内のマーカーブロック（ブロックを削除し、ファイルは保持）と ~/.codex/prompts 内の opsx-*.md プロンプト。
• openspec/ フォルダ：一時停止してください。specs/ と changes/archive/ はシステムの記録であり、OpenSpec なしでも問題なく読めるプレーンな Markdown です。
• マシンごとの状態：~/.config/openspec/ の設定とテレメトリー ID。~/.local/share/openspec/ のスキーマ上書き、ストア登録、スタンドアロンインストールの組み込みスキーマ（binary-schemas/）（Windows：%APPDATA%\openspec、%LOCALAPPDATA%\openspec）。登録はポインターであり、参照先のストアリポジトリは影響を受けません。