Kurulum

Ön Gereksinimler

• Node.js 20.19.0 veya üzeri — Sürümünüzü kontrol edin: node --version

AI asistanınızla kurulum

Bunu elle yapmak istemiyor musunuz? Aşağıdaki komutu, kabuk komutları çalıştırabilen herhangi bir kodlama asistanına yapıştırın — Claude Code, Codex, Cursor, Gemini CLI, Copilot ve diğer desteklenen araçlar. Bu komut CLI'yi kurar, bu projeyi başlatır ve neyin gerçekleştiğini raporlar.

Aşağıdaki manuel adımlar tek doğruluk kaynağıdır — komut yalnızca bunları sizin için çalıştırır. Asistanınız durup size bir şey geri döndürürse, bu tasarımı gereğidir: ayrıcalıklı işlemler öncesi sorar ve kabuk başlangıç dosyalarınızı asla düzenlemez. Bu adımları Paket Yöneticileri ve Sorun Giderme bölümlerini kullanarak kendiniz tamamlayın.

Install OpenSpec in this project and set it up for me. Follow these steps in
order, and stop where a step tells you to stop.

1. RUNTIME. Run `node --version`. OpenSpec needs Node.js 20.19.0 or higher. If
   Node is missing or older, say so and stop — don't install Node, switch
   versions, or reconfigure my version manager for me.

2. INSTALL. Use whichever package manager is already on my PATH, preferring 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 only)
   Don't pick based on this project's lockfile — a global install has nothing to
   do with how this repo's own dependencies are installed. If none of those four
   is available, stop and tell me — don't improvise an install. (If I'm on Nix,
   point me at the Nix section of the OpenSpec installation docs instead.)
   Show me the exact command and let me confirm before you run it; this installs
   software outside the project, and I may want a different package manager to
   own it.
   Stop and ask me again if the install needs sudo or admin rights, fails with a
   permissions error, or reports that its global bin directory is missing or
   unconfigured. Never edit my shell startup files (.bashrc, .zshrc, .profile,
   fish, PowerShell profile), and never run a setup command that edits them for
   me — show me the change and let me make it.

3. PATH. Run `openspec --version`. If the command isn't found, it may just be
   missing from this shell: tell me where the package manager installed it and
   how to add that directory to PATH for my shell and OS, then stop until I
   confirm. If it prints an older version than the one the install just
   reported, an earlier copy is shadowing it on PATH — tell me both versions
   instead of continuing. If I use a version manager, say so rather than editing
   PATH around it: with nvm or fnm the CLI is tied to the Node version that was
   active when you installed it, and with asdf or volta a shim may need
   regenerating.

4. INITIALIZE. Ask me which AI coding tool or tools I use and map each to an id
   from `openspec init --help` (Copilot is `github-copilot`, Zoo Code is
   `roocode`). `--tools` takes a comma-separated list, so name all of them.
   `openspec init --tools <ids>` deletes leftovers from older OpenSpec versions
   automatically, without asking — including `opsx-*.md` prompt files in my home
   directory (Codex keeps them in ~/.codex/prompts). Before you run it, look for
   those: `.../commands/openspec/` folders, OpenSpec marker blocks in files like
   CLAUDE.md or AGENTS.md, and home-directory `opsx-*.md` prompts. List whatever
   you find and wait for my go-ahead; if you find nothing, say so and carry on
   without asking. An existing `openspec/` folder is not a problem — init
   refreshes it and leaves my specs and changes alone.
   Confirm I'm in the right folder too: init creates `openspec/` wherever it
   runs, including inside a monorepo package.
   Then run: openspec init --tools <ids>

5. REPORT. Don't assume what should exist — tell me what init actually printed:
   how many skills and/or commands it created and where, the config file line,
   any "Setup required" note, and what to restart or reload. Some tools are
   skills-only and correctly create zero command files, so missing commands is
   not a failure on its own. If init said nothing was generated, relay the fix
   it suggested instead of retrying. Finish by telling me how to invoke OpenSpec
   in my tool, and take the exact spelling from the files init created rather
   than from its summary line: the punctuation differs per tool (/opsx:propose
   in some, /opsx-propose in others, @opsx-propose in Amazon Q), and tools that
   get skills instead of commands are invoked by skill name (/openspec-propose,
   or $openspec-propose in Codex, or /skill:openspec-propose in Kimi Code).

Komutun içeriğinde satıcıya özgü hiçbir şey yok: düz talimatlar ve bu sayfada belgelenen aynı komutlardan oluşuyor. macOS, Linux ve Windows'ta çalışır ve bir adım izninizi gerektirdiğinde keyfi davranmak yerine bilinçli olarak durur. Asistanınızın kabuk komutları çalıştırabilmesi gerekir — bazı IDE entegrasyonları bunu yapamaz.

Paket Yöneticileri

npm

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

pnpm

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

yarn

yarn global add @fission-ai/openspec@latest

Yarn 2 ve üzeri sürümler (Berry) global komutunu kaldırdı. Bu sürümlerde OpenSpec'i npm, pnpm veya bun ile kurun — küresel bir CLI'nın projenizin paket yöneticisiyle aynı olması gerekmez.

deno

Deno bazen @latest etiketini ayrıştırırken sorun yaşayabilir, ancak ilk kurulumda sürüm belirtilebilir. Böyle bir durumla karşılaşırsanız, @latest etiketini sürüm numarasıyla değiştirmeyi deneyebilirsiniz, örneğin @^1.3.1 gibi.

deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest
# or
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

Not: Alt komutlarınız config edit, feedback veya workspace open gibi dış araçları başlatıyorsa, kapsamlı bir --allow-run=<program> parametresine ihtiyacınız olabilir.

bun

Bun, OpenSpec'i küresel olarak kurabilir, ancak OpenSpec şu anda Node.js üzerinde çalışır. PATH üzerinde Node.js 20.19.0 veya üzeri sürümün mevcut olması hâlâ gerekir.

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

Nix

OpenSpec'i kurulum gerektirmeden doğrudan çalıştırın:

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

Veya profilinize kurun:

nix profile install github:Fission-AI/OpenSpec

Veya geliştirme ortamınıza flake.nix dosyasına ekleyin:

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

Kurulumu Doğrulama

openspec --version

Güncelleme

Paketi yükseltin, ardından her projenin oluşturulan dosyalarını yenileyin:

npm install -g @fission-ai/openspec@latest   # or pnpm/yarn/bun equivalent
openspec update                              # run inside each project

openspec update, yapılandırdığınız araçlar için beceri ve komut dosyalarını yeniden oluşturur, böylece slash komutlarınız kurulu sürümle güncel kalır. Ayrıca daha yeni bir CLI sürümünün yayınlanıp yayınlanmadığını kontrol eder ve yükseltme önerir, çünkü yeni iş akışlarının kullanılabilir hale gelmesini sağlayan şey yükseltmedir — bkz. CLI Referansı.

Kaldırma

openspec uninstall komutu yoktur, çünkü OpenSpec yalnızca küresel bir paket ve projenizdeki bazı dosyalardan ibarettir. Kaldırma birkaç manuel adım gerektirir ve burada hiçbir şey kaynak kodunuza dokunmaz.

1. Küresel paketi kaldırın:

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

2. OpenSpec'i bir projeden kaldırın (isteğe bağlı). Artık spesifikasyonlarını ve değişikliklerini istemiyorsanız openspec/ dizinini silin:

rm -rf openspec/

Bunu yapmadan önce düşünün: openspec/specs/ ve openspec/changes/archive/ dizinleri, sistemin nasıl davrandığına ve neden değiştiğine dair kaydınızdır. Bu geçmişi isterseniz, kaldırma işleminden sonra bile klasörü (veya git'te tutun) saklayın.

3. Oluşturulan AI araç dosyalarını kaldırın (isteğe bağlı). OpenSpec, .claude/skills/openspec-*/, .cursor/commands/opsx-* gibi araç başına dizinlere beceri ve komut dosyaları yazar. Yapılandırdığınız araçlar için openspec-* becerilerini ve opsx-* komutlarını silin. Araç başına kesin yollar Desteklenen Araçlar sayfasında listelenmiştir.

Ayrıca CLAUDE.md veya AGENTS.md gibi dosyalarda OpenSpec işaretçi blokları varsa, bu blokları elle kaldırın; bu dosyalardaki kendi içeriğiniz sizin hakkınızdır.

Sonraki Adımlar

Kurulumdan sonra OpenSpec'i projenizde başlatın:

cd your-project
openspec init

Tam bir anlatım için Başlangıç sayfasına bakın.