Установка

Установите CLI openspec на вашу машину, обновите его и удалите.

Установка

На 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 --version

Если это выведет v22.12.0 или выше, установите с помощью npm:

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

Если нет, установите более новый Node с nodejs.org или через ваш менеджер версий (nvm, fnm, asdf, volta), или используйте вместо этого автономную установку.

Homebrew

Homebrew устанавливает OpenSpec и его зависимость Node.js на macOS или Linux. В терминале:

brew install openspec

Формула опубликована в homebrew-core, поэтому вам не нужно добавлять tap.

Yarn

yarn global add работает только в Yarn Classic (1.x). Современный Yarn удалил глобальные установки, поэтому используйте вместо него npm, pnpm или bun. Глобальный CLI не обязан использовать менеджер пакетов вашего проекта.

Bun

Bun устанавливает OpenSpec, но не запускает его, поэтому вам всё равно нужен Node на машине (см. Менеджеры пакетов). Без него каждая команда завершается ошибкой env: node: No such file or directory. Bun обращается с каждым Node CLI таким образом.

Deno

Deno устанавливает CLI из npm и требует явных флагов разрешений. В терминале:

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, поэтому afterwards проверять установку не нужно.

Чтобы вместо этого поместить OpenSpec в dev shell проекта, добавьте flake как input и используйте его default package; 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 перед установкой.

Загрузка вручную

Каждый релиз содержит один файл для каждого компьютера:

Компьютер	Файл
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 принадлежит одной установке Node. Переключите версии Node с помощью nvm, и команда 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. Удалите оставшееся или сохраните его.

• Сгенерированные файлы агента: навыки openspec-* и команды opsx в каталогах вида .claude/ или .agents/, для каждого проекта. Поддерживаемые инструменты перечисляют пути каждого инструмента; MiniMax Code хранит навыки в ~/.minimax/skills.
• Остатки от старых версий: маркерные блоки в CLAUDE.md или AGENTS.md (удалите блок, сохраните файл) и промпты opsx-*.md в ~/.codex/prompts.
• Папка openspec/: сначала подумайте. specs/ и changes/archive/ — это ваша запись системы, обычный Markdown, который хорошо читается без OpenSpec.
• Состояние машины: настройки и идентификатор телеметрии в ~/.config/openspec/; переопределения схем, регистрации хранилищ и встроенные схемы автономной установки (binary-schemas/) в ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Регистрации — это указатели; репозитории хранилищ, на которые они ссылаются, не тронуты.