Встановлення

Встановіть 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, тому після цього немає чого перевіряти.

Щоб натомість додати OpenSpec у dev shell проєкту, додайте flake як input і використовуйте його пакет за замовчуванням; flake.nix перелічує виходи.

Пакет 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 install.

Оновлення

У вашому терміналі, у кожному проєкті, де ви запускали 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). Реєстрації — це вказівники; репозиторії сховищ, на які вони вказують, не змінюються.