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

Передумови

Node.js 20.19.0 або новіша версія — Перевірте свою версію: node --version

Встановлення за допомогою вашого AI-помічника

Не хочете робити це вручну? Вставте наведений нижче запит у будь-якого AI-помічника для кодування, який може виконувати команди оболонки — Claude Code, Codex, Cursor, Gemini CLI, Copilot та інші підтримувані інструменти. Він встановить CLI, ініціалізує цей проєкт та повідомить, що саме сталося.

Наведені нижче кроки вручну є джерелом істини — цей запит лише запускає їх за вас. Якщо ваш помічник зупиняється і повертає щось вам, це зроблено навмисно: він запитує перед виконанням привілейованих дій і ніколи не редагує ваші файли запуску оболонки. Завершіть ці частини самостійно за допомогою розділів Менеджери пакетів та Вирішення проблем.

text

Встановіть 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)
   Не обирайте на основі lock-файлу цього проєкту — глобальне встановлення не має нічого
   спільного з тим, як встановлюються залежності цього репозиторію. Якщо жоден із цих чотирьох
   недоступний, зупиніться і скажіть мені — не імпровізуйте зі встановленням. (Якщо я використовую Nix,
   направте мене до розділу Nix у документації зі встановлення OpenSpec.)
   Покажіть мені точну команду і дайте підтвердити, перш ніж виконувати; це встановить програмне забезпечення
   поза проєктом, і я можу захотіти, щоб за це відповідав інший менеджер пакетів.
   Зупиніться і запитайте мене ще раз, якщо для встановлення потрібні права sudo або адміністратора, воно
   завершується помилкою дозволу або повідомляє, що відсутній або не налаштований його глобальний каталог bin.
   Ніколи не редагуйте мої файли запуску оболонки (.bashrc, .zshrc, .profile, fish, профіль PowerShell)
   і ніколи не запускайте команду налаштування, яка редагує їх за мене — покажіть мені зміни і дозвольте
   зробити їх самостійно.

3. PATH. Запустіть `openspec --version`. Якщо команду не знайдено, можливо, її просто немає в цій оболонці:
   скажіть мені, куди менеджер пакетів її встановив і як додати цей каталог до PATH для моєї оболонки та ОС,
   потім зупиніться, поки я не підтверджу. Якщо вона виводить старішу версію, ніж щойно зазначена при
   встановленні, старіша копія затьмарює її в PATH — скажіть мені обидві версії, замість того щоб продовжувати.
   Якщо я використовую менеджер версій, скажіть про це, замість того щоб редагувати PATH довкола нього:
   з nvm або fnm CLI прив'язаний до версії Node, яка була активною під час встановлення, а з asdf або volta
   може знадобитися перегенерація прокладки (shim).

4. ІНІЦІАЛІЗАЦІЯ. Запитайте мене, який інструмент(и) для кодування зі штучним інтелектом я використовую,
   і зіставте кожен з ідентифікатором із `openspec init --help` (Copilot — це `github-copilot`,
   Zoo Code — це `roocode`). `--tools` приймає список, розділений комами, тому назвіть їх усі.
   `openspec init --tools <ids>` автоматично видаляє залишки від старіших версій OpenSpec, без запитань —
   включно з файлами підказок `opsx-*.md` у моєму домашньому каталозі (Codex зберігає їх у ~/.codex/prompts).
   Перш ніж запускати, перевірте наявність: тек `.../commands/openspec/`, блоків-маркерів OpenSpec
   у файлах на кшталт CLAUDE.md або AGENTS.md та підказок `opsx-*.md` у домашньому каталозі.
   Перелічіть усе, що знайдете, і дочекайтеся мого дозволу; якщо нічого не знайдете, повідомте про це
   і продовжуйте без запитань. Наявна тека `openspec/` не є проблемою — init оновлює її і залишає мої
   специфікації та зміни без змін.
   Також підтвердьте, що я перебуваю у правильній теці: init створює `openspec/` там, де запускається,
   включно з серединою пакета монорепозиторію.
   Потім запустіть: openspec init --tools <ids>

5. ЗВІТ. Не припускайте, що має існувати — скажіть мені, що init насправді вивів:
   скільки навичок та/або команд було створено і де, рядок файлу конфігурації, будь-яку примітку
   "Потрібне налаштування" і що потрібно перезапустити або перезавантажити. Деякі інструменти
   мають лише навички і правильно створюють нуль файлів команд, тому відсутність команд сама по собі
   не є помилкою. Якщо init повідомив, що нічого не згенеровано, передайте запропоноване ним
   виправлення замість повторної спроби. На завершення скажіть мені, як викликати OpenSpec
   у моєму інструменті, і візьміть точне написання з файлів, створених init, а не з його підсумкового рядка:
   пунктуація відрізняється залежно від інструменту (/opsx:propose в одних, /opsx-propose в інших,
   @opsx-propose в Amazon Q), а інструменти, які отримують навички замість команд, викликаються за назвою навички
   (/openspec-propose, або $openspec-propose у Codex, або /skill:openspec-propose у Kimi Code).

Ніщо в цьому запиті не прив'язане до конкретного постачальника: це прості інструкції плюс ті самі команди, задокументовані на цій сторінці. Він працює на macOS, Linux та Windows, і навмисно зупиняється, а не імпровізує, коли крок потребує вашого дозволу. Ваш помічник повинен мати можливість виконувати команди оболонки — деякі інтеграції IDE не можуть цього робити.

Менеджери пакетів

npm

bash

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

pnpm

bash

pnpm add -g @fission-ai/openspec@latest

yarn

bash

yarn global add @fission-ai/openspec@latest

Yarn 2 та новіші версії (Berry) вилучили команду global. У цих версіях встановлюйте OpenSpec за допомогою npm, pnpm або bun — глобальний CLI не зобов'язаний використовувати той самий менеджер пакетів, що й ваш проєкт.

deno

Deno іноді має проблеми з розбором тегу @latest, але ми можемо вказати версію під час початкового встановлення. Якщо це станеться, спробуйте замінити тег @latest на версію, наприклад, @^1.3.1

bash

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

Примітка: Якщо ваші підкоманди запускають зовнішні інструменти, як-от редагування конфігурації, зворотний зв'язок або відкриття робочого простору, вам може знадобитися scoped --allow-run=<program>.

bun

Bun може встановити OpenSpec глобально, але наразі OpenSpec працює на Node.js. Вам все одно потрібна Node.js 20.19.0 або новіша, доступна у PATH.

bash

bun add -g @fission-ai/openspec@latest

Nix

Запустіть OpenSpec безпосередньо без встановлення:

bash

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

Або встановіть у ваш профіль:

bash

nix profile install github:Fission-AI/OpenSpec

Або додайте до свого середовища розробки у flake.nix:

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 ];
    };
  };
}

Перевірка встановлення

bash

openspec --version

Оновлення

Оновіть пакет, а потім оновіть згенеровані файли кожного проєкту:

bash

npm install -g @fission-ai/openspec@latest   # або еквівалент для pnpm/yarn/bun
openspec update                              # запустіть всередині кожного проєкту

openspec update перегенеровує файли навичок і команд для інструментів, які ви налаштували, тому ваші слеш-команди залишаються актуальними зі встановленою версією. Він також перевіряє, чи було опубліковано новішу версію CLI, і пропонує оновитися, оскільки саме оновлення робить нові робочі процеси доступними — див. Довідник CLI.

Видалення

Команди openspec uninstall не існує, оскільки OpenSpec — це лише глобальний пакет плюс деякі файли у вашому проєкті. Видалення складається з кількох ручних кроків, і ніщо тут не зачіпає ваш вихідний код.

1. Видаліть глобальний пакет:

bash

npm uninstall -g @fission-ai/openspec   # або: pnpm rm -g / yarn global remove / bun rm -g

2. Видаліть OpenSpec з проєкту (необов'язково). Видаліть теку openspec/, якщо ви більше не хочете зберігати її специфікації та зміни:

bash

rm -rf openspec/

Подумайте, перш ніж робити це: openspec/specs/ та openspec/changes/archive/ — це ваш запис того, як система поводиться і чому вона змінювалася. Якщо ви можете захотіти цю історію, залиште теку (або збережіть її в git) навіть після видалення.

3. Видаліть згенеровані файли AI-інструментів (необов'язково). OpenSpec записує файли навичок і команд у теки конкретних інструментів, такі як .claude/skills/openspec-*/, .cursor/commands/opsx-* тощо. Видаліть навички openspec-* та команди opsx-* для тих інструментів, які ви налаштували. Точні шляхи для кожного інструменту наведені в Підтримуваних інструментах.

Якщо у вас також є блоки-маркери OpenSpec у файлах, таких як CLAUDE.md або AGENTS.md, видаліть ці блоки вручну; ваш власний вміст у цих файлах залишається вашим.

Наступні кроки

Після встановлення ініціалізуйте OpenSpec у своєму проєкті:

bash

cd your-project
openspec init

Дивіться Початок роботи для повного покрокового керівництва.

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

Передумови ​