Kurulum

openspec CLI'nizi makinede yükleyin, güncelleyin ve kaldırın.

Yükleme

macOS veya Linux'ta terminallerinizde:

curl -fsSL https://openspec.dev/cli/install.sh | sh

Windows'ta PowerShell'de:

irm https://openspec.dev/cli/install.ps1 | iex

Yükleyicinin bir export PATH=... satırı yazdırması durumunda bunu çalıştırın. Ardından kontrol edin.

Yardımcı programınızla yükleme

Yardımınıza bir sohbete yapıştırın:

Fetch https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md and follow it.

Ayrıca terminallerinizden birine bunu bir komut istemine yapıştırın (Claude Code gösterilmektedir):

curl -fsSL https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md | claude

Bu, repo kökündeki install.md'yi çektiği anlamına gelir, herhangi bir komut istemesi çalıştırabilir (birkaç IDE entegrasyonu yapamadığı) yazılmış bir sorudur. Yardımcınızın yapmasını bekleyin:

1. CLI'niz zaten makinede varsa yüklamayı atlayın ve önceki yüküm şeklini güncellemek için teklifte bulunun. Eğer bu npm veya Homebrew olduysa, openspec install bağımsız yüküye geçerken onu zorlamadığını tekrar belirtin. Aksi takdirde yukarıdaki yükleme komutunu gösterip çalıştırmadan önce onayınızı bekleyin.
2. Sadece sizin isteğiniz veya yükleyici başarısız olduysa npm kullanın ve Node'unuzun 22.12.0'dan daha eski olduğunda durun.
3. openspec'in PATH'inizde olduğundan emin olun.
4. Anladığı klasörü adlandırın, zaten konuştuğunuz yardımcı programı önerin ve hangilerini kullanıp kullanmayacağınızı sorun, ardından openspec init'i oraya çalıştırın (proje kurulumu adımı).
5. Init tarafından oluşturulan şeyi ve OpenSpec'i belirli harflerle çağıran komutu rapor edin.

Herhangi bir ayrıcalıklı şeyi yapmadan durur ve kabuk başlangıç dosyalarını düzenlemez. Yukarıdaki yükleme komutu ve aşağıdaki paket yöneticileri gerçeğin kaynağıdır ve soru onu sizin için çalıştırır.

Bu yükleme yöntemi yeni ve kullanılan modelden bağımsız olarak farklı sonuçlar doğurabilir. Sadece AI hatalarını düzeltmeye hazır olduğunuzda kullanın. Aksi takdirde aşağıdaki standart yöntemi izleyin.

Paket Yöneticileri

Bu, OpenSpec'i Node.js paketi olarak yükler, bu yüzden Node.js 22.12.0 veya daha yeni gerekir (Homebrew ve Nix kendi sürücülerini getirir). Terminallerinizde:

node --version

Eğer v22.12.0 veya daha yüksek çıkarsa npm ile yükleyin:

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

Buna karşılık, nodejs.org'dan daha yeni bir Node yükleyin veya sürüm yöneticisi (nvm, fnm, asdf, volta) aracılığıyla veya bağımsız yükleme'i kullanın.

Homebrew

Homebrew, macOS veya Linux'ta OpenSpec ve onun Node.js bağımlılığını yükler. Terminallerinizde:

brew install openspec

Formül, homebrew-core'de yayınlanmıştır, bu yüzden ek bir tap eklemenize gerek yoktur.

Yarn

yarn global add sadece Yarn Classic (1.x) içindir. Modern Yarn global yüklemeleri kaldırdı, bu yüzden npm, pnpm veya bun yerine kullanın. Genel bir komut isteminiz proje paket yöneticisini paylaşmak zorunda değildir.

Bun

Bun OpenSpec'i yükler ama çalıştırmasını yapmaz, bu yüzden makinede hâlâ Node olması gerekir (Paket Yöneticileri'ne bakın)). Buna karşılık, her komut env: node: No such file or directory hatasıyla başarısız olur. Bun, her Node CLI'ye bu şekilde davranır.

Deno

Deno, npm'den CLI'yi yükler ve açık izin bayrakları gerektirir. Terminallerinizde:

deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest

Bazı komutlar başka bir programı çalıştırır: openspec config edit editörünüzü açar. Deno her çalıştırmada bunları izin isteğiyle keser. Bu isteği durdurmak için yükleme komutuna bir kapsamlı --allow-run=<program> ekleyin.

NOTE

Eğer Deno @latest'i çözemezse, yerine bir sürüm aralığını sabitleyin: npm:@fission-ai/openspec@^1.7.0.

Nix

OpenSpec deposu bir Nix flak sunuyor. profilinize yükleyin. Terminallerinizde:

nix profile install github:Fission-AI/OpenSpec

Veya önceden bir geçiş komutu çalıştırın, yüklemekten kaçının:

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

Bu, PATH'inizde hiçbir şey bırakmaz, böylece sonra kontrol etme yüklemesi yoktur.

Alternatif olarak, bir projeye gelişim kabuğu koymak için flake'i girdi olarak ekleyin ve varsayılan paketini kullanın; flake.nix çıktıları listeler.

Nix paketi, standart konumlarda (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions) Bash, Fish ve Zsh tamamlama betiklerini taşır, bu yüzden paketle birlikte yüklenir ve openspec completion install çalıştırma ihtiyacı yoktur.

Başarılı oldu mu kontrolü

Kullanılan herhangi bir yöntemle, terminallerinizde:

openspec --version

Eğer bir sürüm numarası yazarsa, CLI'iniz PATH'inizdedir. Her makineye bir kez yükler.

Sonra, projenizi ayarlayın. Yardımcınız zaten init'i çalıştırdıysa, bu sayfa ne yazdığını ve nasıl ayarlayacağınızı gösterir.

Yükleme Seçenekleri

Sürüm veya klasör seçmek için sh'den önce bir değişken ayarlayın:

curl -fsSL https://openspec.dev/cli/install.sh | OPENSPEC_VERSION=v1.15.0 sh

• OPENSPEC_VERSION: yüklemek üzere yayınlanan sürüm, örn. v1.15.0.Varsayılan en yeni sürümdür.
• OPENSPEC_INSTALL_DIR: yüklemek üzere klasör.Varsayılan ~/.local/bin'dir (Windows: %LOCALAPPDATA%\Programs\openspec).

Windows'ta değişkeni önce ayarlayın:

$env:OPENSPEC_VERSION = 'v1.15.0'
irm https://openspec.dev/cli/install.ps1 | iex

Alpine Linux'ta yüklemeden önce apk add libstdc++ libgcc'ü çalıştırın.

El ile indir

Her sürüm, her bilgisayara bir dosya sahiptir:

Bilgisayar	Dosya
Mac, Apple silisyon	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. Yükle dosyanızı son sürümünden. Dosyalar bir sürüm yayınlandıktan sonra birkaç dakika içinde eklenir. Eğer henüz listede yoksa bekleyin ve yeniden yükleyin veya önceki sürümden alış.
2. Paketini aç dosyasını. Terminalinizde: tar -xzf openspec-darwin-arm64.tar.gz. Windows'ta, .zip'ye sağ tık yapın ve Çek'i seçin.
3. MacOS'ta, açtığınız klasöre çalıştırın xattr -d com.apple.quarantine openspec. Tarayıcıdan indirilen dosyalar blokludur, bunu yapmadan.
4. Taşı openspec'i PATH'inizdeki bir klasöre, örn. ~/.local/bin, gibi. Windows'ta, kullanıcı PATH'inizdeki bir klasöre taşıyın, örn. %LOCALAPPDATA%\Programs\openspec, gibi.

İndirmeyi doğrulama

Bir dosyanın OpenSpec sürümü iş akışı tarafından build edildiğini kontrol etmek için, GitHub CLI'yle bu komutu çalıştırın:

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

İş akışı dosyayı build etmediyse başarısız olur. Yükleme komutu her indirimi sürümün SHA256SUMS'üne karşı kontrol eder, bu adım isteğe bağlıdır.

npm'den bağımsız yüklemenize geçme

Geçiş zorunlu değil; npm çalışmaya devam eder. Ayarlarınız ve projeleriniz taşır; sadece program değişir.

1. Bağımsız kopyayı yükle. Terminallerinizde:

openspec install

Bağımsız openspec'i yükler ve npm veya Homebrew kopyasını kaldıracak komutu yazdırır.

2. Eski kopyayı kaldır. Genellikle PATH'inizde ilk gelir, bu yüzden bitene kadar çalışmaya devam eder. 1. Adımda yazdırılan komutu çalıştırın, örn.:

npm uninstall -g @fission-ai/openspec

3. Hangi kopyanın çalıştığını kontrol et. Yeni bir kabuk açın:

openspec version

Bunun OpenSpec < sürüm> (bağımsız) yazması gerekir. Aksi takdirde başka bir kopya hâlâ PATH'inizde: which -a openspec (Windows: where.exe openspec) tüm kopyaları listeler, diğerlerini kaldırın.

Proje yeniden başlatılması gerekmez. Geri dönmek için dosyayı silin ve npm yüklemesini tekrar çalıştırın.

Güncelleme

Terminallerinizde, init'i çalıştırdığınız her projede:

openspec update

Daha yeni bir CLI çıktığında, openspec update bunu söyler ve sizin için yükleyebilir; bu yükseltme her makineye bir kez yapılır. Her çalıştırma projeyi ürettiğiniz beceriler ve komutları yeniler, bunlar kendi başlarına güncellenmez. Mevcut bir projede ✓ Tüm 2 araç güncel (v1.7.0) yazılır.

WARNING

Bağımsız yüklemede, kopyayı yerinde değiştirmek için openspec install'u çalıştırın; openspec update yeni bir çıktığında size haber verir. Homebrew'de brew upgrade openspec'i çalıştırın. Deno'da, -f ile Deno yüklemesi'yi yeniden çalıştırın; olmadan yüklenmiş komutu üzerine yazmaz. Nix'te nix profile upgrade openspec'ü kullanın.

NOTE

Genel bir npm yüklemesi bir Node yüklemesine aittir. nvm ile Node sürümlerini değiştirirken openspec komutu gelmez, bu yüzden yeni sürüm altında tekrar yükleyin.

Kaldırma

OpenSpec'i kaldırmak için aşağıdaki adımları çalıştırın; bunların hiçbiri kaynak kodunuza dokunmaz. Ayrıca bu bölümü yardımcınıza işaret edebilirsiniz ve onu kaldırmasına izin verebilirsiniz.

1. kabuk tamamlamalarını , CLI bunu hâlâ yapabildiği sürece, eğer ayarladıysanız kaldırın. Terminallerinizde:

openspec completion uninstall

2. CLI'yi kaldırın. Bağımsız yüklemede, ~/.local/bin/openspec'ü (Windows: %LOCALAPPDATA%\Programs\openspec, ve kullanıcı PATH'inizden bu klasörü) silin. npm'de, terminallerinizde:

npm uninstall -g @fission-ai/openspec

Homebrew: brew uninstall openspec. Deno: deno uninstall --global openspec. Nix: nix profile remove openspec. Kabuğunuz artık openspec'i bulamaz.

3. Kalanı sil, veya sakla.

• Oluşturulan yardımcı dosyaları: openspec-* becerileri ve opsx komutları, .claude/ veya .agents/ gibi dizinlerde, her projeye göre. Desteklenen araçlar her aracın yollarını listeler; MiniMax Code ~/.minimax/skills'de becerileri saklar.
• Daha eski sürümlerden kalıntılar: CLAUDE.md veya AGENTS.md'de işaret blokları (bloku sil, dosyayı sakla) ve ~/.codex/prompts'de opsx-*.md sorular.
• openspec/ klasörü: öncelikle durdurun. specs/ ve changes/archive/ sistemi kaydınız, OpenSpec olmadan okunabilir düzgün Markdown'tur.
• Her makine durumu: ayarlar ve telemetri id'si ~/.config/openspec/'de; şema geçişleri, depolar kayıtları ve bağımsız yüklemenin varsayılan şemaları (binary-schemas/) ~/.local/share/openspec/'de (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Kayıtlar işaretlerdir; işaret ettikleri depoları değiştirilmemiştir.