Установка

УстановкаCopy Anchor Link

OpenSpec устанавливается как единый файл openspec. Для него не нужен Node.js.

В macOS или Linux выполните в терминале:

curl -fsSL https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/scripts/binary/install.sh | sh

В Windows выполните в PowerShell:

irm https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/scripts/binary/install.ps1 | iex

• Куда устанавливается: ~/.local/bin; в Windows — %LOCALAPPDATA%\Programs\openspec (путь добавляется в пользовательский PATH).
• Что проверяется: установщик выбирает файл для вашей платформы и сверяет его с SHA256SUMS релиза перед установкой.
• Какой релиз: самый новый, к которому прикреплены все файлы. В течение нескольких минут после публикации релиза, пока файлы загружаются, устанавливается предыдущий релиз с соответствующим уведомлением.
• Alpine Linux: сначала выполните apk add libstdc++ libgcc.
• Параметры: задайте OPENSPEC_INSTALL_DIR для установки в другой каталог или OPENSPEC_VERSION=v1.15.0 для закрепления конкретного релиза.

Если установщик сообщит, что папка отсутствует в вашем PATH, добавьте её согласно выведенной инструкции. Затем проверьте работоспособность.

Сам процесс выполняется внутри ИИ-инструмента для написания кода: Claude Code, Cursor или любого другого инструмента из списка поддерживаемых.

Самостоятельное скачиваниеCopy Anchor Link

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

Переименуйте файл в openspec (openspec.exe в Windows), выполните chmod +x openspec в macOS или Linux и поместите его в каталог из вашего PATH.

Проверка скачанного файлаCopy Anchor Link

Каждый бинарный файл релиза снабжён подписанной записью запуска процесса сборки, который его создал. С помощью GitHub CLI выполните в терминале:

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

Команда подтвердит, что файл действительно был собран процессом этого релиза, или завершится ошибкой. Этот шаг необязателен: установщик уже проверяет каждое скачивание по SHA256SUMS.

Установка с помощью ИИ-ассистентаCopy Anchor Link

Вставьте это в чат с вашим ИИ:

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 из корня репозитория — промпт, написанный для любого агента, умеющего выполнять shell-команды (некоторые интеграции для IDE этого не умеют). Ваш ассистент выполнит следующие действия:

1. Пропустит установку, если CLI уже есть на вашем компьютере, и предложит обновить его тем же способом, каким он был установлен. Если использовался npm или Homebrew, ассистент один раз упомянет без навязывания, что openspec install переключает на автономную установку. В противном случае он покажет команду установки, приведённую выше, и дождётся вашего подтверждения перед запуском.
2. Использует npm, только если вы сами об этом попросите или если установщик завершится ошибкой, и остановится, если версия Node старше 20.19.0.
3. Проверит, что openspec доступен в вашем PATH.
4. Назовёт целевую папку проекта, предложит ИИ-инструмент, в котором вы сейчас общаетесь, спросит, какими ещё инструментами вы пользуетесь, а затем запустит там openspec init (шаг настройки проекта).
5. Сообщит, какие файлы создала инициализация и как именно вызывать OpenSpec в вашем инструменте.

Ассистент останавливается перед любыми действиями, требующими повышенных привилегий, и никогда не редактирует конфигурационные файлы вашей оболочки. Команда установки выше и пакетные менеджеры ниже являются источником истины, а промпт просто запускает их за вас.

Этот метод установки новый, и его результаты могут различаться в зависимости от используемой модели. Применяйте его, только если вы готовы исправлять возможные ошибки ИИ. В противном случае рекомендуем следовать стандартному методу ниже.

Пакетные менеджерыCopy Anchor Link

Эти менеджеры устанавливают OpenSpec как пакет Node.js, поэтому им требуется Node.js 20.19.0 или новее (Homebrew и Nix устанавливают собственную копию). Проверьте версию в терминале:

node --version

Если команда выводит v20.19.0 или выше, установите пакет через npm:

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

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

HomebrewCopy Anchor Link

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

brew install openspec

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

YarnCopy Anchor Link

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

BunCopy Anchor Link

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

DenoCopy Anchor Link

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> в команду установки.

NixCopy Anchor Link

Репозиторий OpenSpec содержит Nix flake. Установите его в свой профиль в терминале:

nix profile install github:Fission-AI/OpenSpec

Или сначала запустите разовую команду без установки:

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

При этом в ваш PATH ничего не добавляется, поэтому проверять установку после запуска не нужно.

Чтобы добавить OpenSpec в dev-оболочку проекта, подключите flake как вход (input) и используйте его пакет по умолчанию; список выходов приведён в flake.nix.

Пакет Nix включает скрипты автодополнения для Bash, Fish и Zsh в стандартных каталогах (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), поэтому они загружаются вместе с пакетом, и запускать openspec completion install не требуется.

Проверка работоспособностиCopy Anchor Link

Независимо от выбранного способа установки выполните в терминале:

openspec --version

Если выводится номер версии, значит CLI находится в вашем PATH. Установка выполняется один раз на компьютер.

Далее перейдите к настройке проекта. Если ваш ассистент уже запустил инициализацию, на этой странице описано, какие файлы были созданы и как их настроить.

Переход с npm на автономную установкуCopy Anchor Link

Переход необязателен — версия из 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.

ОбновлениеCopy Anchor Link

В терминале, внутри каждого проекта, где вы запускали инициализацию, выполните:

openspec update

Когда выходит новая версия CLI, команда openspec update сообщает об этом и может установить её за вас; само обновление CLI требуется один раз на компьютер. Каждый запуск также обновляет сгенерированные в проекте навыки (skills) и команды, которые сами по себе автоматически не обновляются. Для актуального проекта выводится ✓ All 2 tool(s) up to date (v1.7.0).

УдалениеCopy Anchor Link

Чтобы удалить 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). Регистрации представляют собой просто указатели — сами репозитории хранилищ, на которые они ссылаются, остаются нетронутыми.