インストール
前提条件
- Node.js 20.19.0 以上 — バージョンの確認方法:
node --version
AI アシスタントを使用してインストール
手動で操作したくない場合は、以下のプロンプトをシェルコマンドを実行できるコーディングアシスタント（Claude Code、Codex、Cursor、Gemini CLI、Copilot、およびサポートされているツールのリストにあるその他のツール）に貼り付けてください。これにより、CLI がインストールされ、プロジェクトが初期化され、実際に何が行われたかが報告されます。
以下の手動手順が信頼できる情報源です — プロンプトはそれらの手順をあなたのために実行するだけです。アシスタントが停止して何かを返してきた場合、それは意図的な動作です：特権が必要な操作の前には必ず確認し、シェルの起動ファイルは一切編集しません。これらの部分は パッケージマネージャー と トラブルシューティング を参照して自分で完了してください。
このプロジェクトに OpenSpec をインストールし、設定してください。以下の手順を
順番に従い、手順で停止するように指示された場所で停止してください。
1. ランタイム。`node --version` を実行します。OpenSpec には Node.js 20.19.0 以上が必要です。
Node が存在しないか、古い場合はその旨を伝えて停止してください — Node のインストールや
バージョンの切り替え、バージョンマネージャーのリコンフィギュアを行わないでください。
2. インストール。すでに PATH にあるパッケージマネージャーを使用してください。優先順位は npm:
npm install -g @fission-ai/openspec@latest
pnpm add -g @fission-ai/openspec@latest
bun add -g @fission-ai/openspec@latest
yarn global add @fission-ai/openspec@latest (Yarn 1.x のみ)
このプロジェクトのロックファイルに基づいて選択しないでください — グローバルインストールは
このリポジトリ自体の依存関係のインストール方法とは無関係です。これら4つがすべて利用できない
場合は停止して伝えてください — インストールを勝手に試みないでください。（Nix を使用している
場合は、OpenSpec のインストールドキュメントの Nix セクションを案内してください。）
実行する前に正確なコマンドを表示し、実行する前に確認させてください。これはプロジェクト外の
ソフトウェアをインストールするため、別のパッケージマネージャーで所有したい場合があります。
インストールに sudo または管理者権限が必要である場合、権限エラーで失敗した場合、または
グローバル bin ディレクトリが存在しないか未構成であると報告された場合は、再度停止して
尋ねてください。シェルの起動ファイル（.bashrc、.zshrc、.profile、fish、PowerShell profile）
を決して編集せず、それらを編集するセットアップコマンドも決して実行しないでください —
変更内容を表示し、自分で行うようにしてください。
3. PATH。`openspec --version` を実行します。コマンドが見つからない場合、単にこのシェルから
見えていない可能性があります。パッケージマネージャーがどこにインストールしたか、そして
そのディレクトリをシェルスと OS の PATH に追加する方法を伝え、確認するまで停止してください。
インストール直前に報告されたバージョンよりも古いバージョンが表示される場合、PATH 上で
以前のコピーがそれをシャドウしています — 続行せずに両方のバージョンを伝えてください。
バージョンマネージャーを使用している場合は、PATH をいじるのではなくその旨を伝えてください：
nvm や fnm を使用している場合、CLI はインストール時にアクティブだった Node バージョンに
紐付いており、asdf や volta を使用している場合、シャドウを再生成する必要があるかもしれません。
4. 初期化。どの AI コーディングツールを使用しているかを尋ね、それぞれを `openspec init --help`
の id にマッピングしてください（Copilot は `github-copilot`、Zoo Code は `roocode`）。
`--tools` はカンマ区切りのリストを受け取るため、すべて名前を入力してください。
`openspec init --tools <ids>` は、確認なしで古い OpenSpec バージョンからの残骸を自動的に
削除します — これにはホームディレクトリの `opsx-*.md` プロンプトファイルが含まれます
（Codex は ~/.codex/prompts に保持します）。実行する前にそれらを探してください：
`.../commands/openspec/` フォルダー、CLAUDE.md や AGENTS.md などのファイル内の OpenSpec
マーカーブロック、およびホームディレクトリの `opsx-*.md` プロンプト。見つかったものを
リストして承認を待ってください；何も見つからない場合はその旨を伝えて、確認なしで続行してください。
既存の `openspec/` フォルダーは問題ではありません — init はそれを更新し、仕様と変更はそのまま
にしておきます。
正しいフォルダーにいることも確認してください：init は実行場所 wherever に `openspec/` を作成します。
モノレポのパッケージ内も含みます。
次に実行します：openspec init --tools <ids>
5. 報告。存在すべきことを想定しないでください — init が実際に出力したものを伝えてください：
作成されたスキルおよび/またはコマンドの数と場所、設定ファイルの行、「Setup required」の
メモ、再起動または再読み込みが必要なもの。一部のツールはスキルのみであり、コマンドファイルを
0個正しく作成するため、コマンドがないこと自体が失敗ではありません。init が何も生成されなかった
と言った場合は、再試行するのではなく、それが提案した修正を伝えてください。最後に、ツール内で
OpenSpec を呼び出す方法を伝え、要約行ではなく init が作成したファイルから正確なスペルを
引用してください：句読点はツールごとに異なります（いくつかでは /opsx:propose、他では
/opsx-propose、Amazon Q では @opsx-propose）、スキルではなくコマンドを取得するツールは
スキル名で呼び出されます（/openspec-propose、または Codex では $openspec-propose、
Kimi Code では /skill:openspec-propose）。プロンプト内のいずれもベンダー固有のものではありません：これはプレーンな指示とこのページに記載されている同じコマンドです。macOS、Linux、Windows で機能し、ステップに許可が必要な場合に勝手に試行するのではなく意図的に停止します。アシスタントはシェルコマンドを実行できる必要があります — 一部の IDE 統合ではできません。
パッケージマネージャー
npm
npm install -g @fission-ai/openspec@latestpnpm
pnpm add -g @fission-ai/openspec@latestyarn
yarn global add @fission-ai/openspec@latestYarn 2 以降（Berry）は global コマンドを削除しました。これらのバージョンでは、npm、pnpm、または bun を使用して OpenSpec をインストールしてください — グローバル CLI はプロジェクトのパッケージマネージャーを共有する必要はありません。
deno
Deno は @latest タグの解析に問題が発生することがありますが、インストール時にバージョンを指定することで対応できます。 その場合、@latest タグをバージョンに変更してみてください。例えば @^1.3.1 のような形式です。
deno install --global \
--allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
npm:@fission-ai/openspec@latest
# または
deno install --global \
--allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
npm:@fission-ai/openspec@^1.3.1注：サブコマンドが外部ツール（設定の編集、フィードバック、ワークスペースのオープンなど）を起動する場合、スコープ付きの --allow-run=<program> が必要になることがあります。
bun
Bun は OpenSpec をグローバルにインストールできますが、OpenSpec は現在 Node.js 上で実行されます。 PATH 上に Node.js 20.19.0 以上が利用可能である必要があります。
bun add -g @fission-ai/openspec@latestNix
インストールせずに OpenSpec を直接実行します：
nix run github:Fission-AI/OpenSpec -- initまたはプロフィールにインストールします：
nix profile install github:Fission-AI/OpenSpecまたは flake.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 ];
};
};
}インストールの確認
openspec --versionアップデート
パッケージをアップグレードし、各プロジェクトの生成されたファイルを更新します：
npm install -g @fission-ai/openspec@latest # または pnpm/yarn/bun の同等コマンド
openspec update # 各プロジェクト内で実行openspec update は、構成したツールのためのスキルとコマンドファイルを再生成するため、スラッシュコマンドはインストールされたバージョンに合わせて最新の状態に保たれます。また、新しい CLI が公開されたかどうかを確認し、アップグレードを提案します。アップグレードこそが新しいワークフローを利用可能にするためです — CLI リファレンス を参照してください。
アンインストール
openspec uninstall コマンドはありません。OpenSpec はグローバルパッケージとプロジェクト内のいくつかのファイルに過ぎないからです。削除するには数手間のマニュアル作業が必要ですが、ここでの操作はソースコードには影響しません。
1. グローバルパッケージの削除：
npm uninstall -g @fission-ai/openspec # または: pnpm rm -g / yarn global remove / bun rm -g2. プロジェクトからの OpenSpec の削除（任意）。 仕様と変更がいらない場合は openspec/ ディレクトリを削除します：
rm -rf openspec/実行前に考えてください：openspec/specs/ と openspec/changes/archive/ は、システムがどのように動作し、なぜ変更されたかの記録です。その履歴が必要になる可能性がある場合は、アンインストール後もフォルダーを保持してください（git に保持しても構いません）。
3. 生成された AI ツールファイルの削除（任意）。 OpenSpec は .claude/skills/openspec-*/、.cursor/commands/opsx-* などのツールごとのディレクトリにスキルとコマンドファイルを書き込みます。構成したツールに応じて、openspec-* スキルと opsx-* コマンドを削除してください。ツールごとの正確なパスは サポートされているツール に記載されています。
CLAUDE.md や AGENTS.md などのファイル内に OpenSpec マーカーブロックがある場合、それらのブロックを手動で削除してください。それらのファイル内の自分のコンテンツは保持可能です。
次のステップ
インストール後、プロジェクトで OpenSpec を初期化します：
cd your-project
openspec init完全なウォークスルーについては はじめに を参照してください。