Instalasi

Instal CLI openspec di mesin Anda, perbarui, dan hapus instalannya.

Instal

Di macOS atau Linux, di terminal Anda:

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

Di Windows, di PowerShell:

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

Jika penginstal mencetak baris export PATH=..., jalankan. Lalu periksa apakah berhasil.

Instal dengan asisten AI Anda

Tempel ini ke dalam obrolan AI Anda:

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

Atau, di terminal Anda, salurkan ke agen CLI (Claude Code ditampilkan):

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

Itu mengambil install.md di root repo, sebuah prompt yang ditulis untuk agen apa pun yang dapat menjalankan perintah shell (beberapa integrasi IDE tidak bisa). Harapkan asisten Anda untuk:

1. Lewati instalasi jika CLI sudah ada di mesin Anda, dan tawarkan untuk memperbaruinya sesuai cara instalasi awalnya. Jika itu npm atau Homebrew, sebutkan sekali bahwa openspec install beralih ke instalasi mandiri, tanpa memaksanya. Jika tidak, tampilkan perintah instalasi di atas dan tunggu konfirmasi Anda sebelum menjalankannya.
2. Gunakan npm hanya jika Anda memintanya atau penginstal gagal, dan berhenti jika Node Anda lebih lama dari 22.12.0.
3. Verifikasi openspec ada di PATH Anda.
4. Sebutkan folder yang menurutnya Anda maksud, sarankan alat AI yang sedang Anda ajak bicara, dan tanyakan alat lain yang Anda gunakan, lalu jalankan openspec init di sana (langkah penyiapan proyek).
5. Laporkan apa yang dibuat init dan ejaan yang tepat untuk memanggil OpenSpec di alat Anda.

Ini berhenti sebelum tindakan yang memerlukan hak istimewa dan tidak pernah mengedit file startup shell Anda. Perintah instalasi di atas dan pengelola paket di bawah adalah sumber kebenaran, dan prompt menjalankannya untuk Anda.

Metode instalasi ini baru dan dapat memberikan hasil yang bervariasi tergantung model yang digunakan. Gunakan hanya jika Anda nyaman memperbaiki kesalahan AI. Jika tidak, kami menyarankan mengikuti metode standar di bawah ini.

Pengelola paket

Ini menginstal OpenSpec sebagai paket Node.js, jadi memerlukan Node.js 22.12.0 atau lebih baru (Homebrew dan Nix membawa Node.js sendiri). Di terminal Anda:

node --version

Jika itu mencetak v22.12.0 atau lebih tinggi, instal dengan npm:

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

Jika tidak, instal Node yang lebih baru dari nodejs.org atau melalui manajer versi Anda (nvm, fnm, asdf, volta), atau gunakan instalasi mandiri sebagai gantinya.

Homebrew

Homebrew menginstal OpenSpec dan dependensi Node.js-nya di macOS atau Linux. Di terminal Anda:

brew install openspec

Formula ini diterbitkan di homebrew-core, jadi Anda tidak perlu menambahkan tap.

Yarn

yarn global add hanya untuk Yarn Classic (1.x). Yarn modern menghapus instalasi global, jadi gunakan npm, pnpm, atau bun sebagai gantinya. CLI global tidak harus berbagi pengelola paket proyek Anda.

Bun

Bun menginstal OpenSpec tetapi tidak menjalankannya, jadi Anda tetap memerlukan Node di mesin Anda (lihat Pengelola paket). Tanpa itu, setiap perintah gagal dengan env: node: No such file or directory. Bun memperlakukan setiap CLI Node dengan cara ini.

Deno

Deno menginstal CLI dari npm dan memerlukan flag izin eksplisit. Di terminal Anda:

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

Beberapa perintah meluncurkan program lain: openspec config edit membuka editor Anda. Deno mengganggu itu dengan prompt izin di setiap run. Untuk menghentikannya bertanya, tambahkan --allow-run=<program> yang dibatasi ke perintah instalasi.

NOTE

Jika Deno tidak dapat menyelesaikan @latest, kunci rentang versi sebagai gantinya: npm:@fission-ai/openspec@^1.7.0.

Nix

Repo OpenSpec menyertakan Nix flake. Instal ke profil Anda. Di terminal Anda:

nix profile install github:Fission-AI/OpenSpec

Atau jalankan perintah sekali pakai terlebih dahulu, tanpa menginstal:

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

Itu tidak meninggalkan apa pun di PATH Anda, jadi tidak ada instalasi untuk diperiksa setelahnya.

Untuk menempatkan OpenSpec di dev shell proyek sebagai gantinya, tambahkan flake sebagai input dan gunakan paket default-nya; flake.nix mencantumkan output-nya.

Paket Nix menyertakan skrip penyelesaian Bash, Fish, dan Zsh di lokasi standar (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions), sehingga skrip tersebut dimuat bersama paket dan tidak perlu menjalankan openspec completion install.

Periksa apakah berhasil

Metode apa pun yang Anda gunakan, di terminal Anda:

openspec --version

Jika itu mencetak nomor versi, CLI ada di PATH Anda. Ini terinstal sekali per mesin.

Selanjutnya, siapkan proyek Anda. Jika asisten Anda sudah menjalankan init, halaman itu menunjukkan apa yang ditulisnya dan cara menyesuaikannya.

Opsi instalasi

Untuk memilih versi atau folder, atur variabel sebelum sh:

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

• OPENSPEC_VERSION: rilis yang akan diinstal, seperti v1.15.0. Default-nya adalah rilis terbaru.
• OPENSPEC_INSTALL_DIR: folder tujuan instalasi. Default-nya adalah ~/.local/bin (Windows: %LOCALAPPDATA%\Programs\openspec).

Di Windows, atur variabel terlebih dahulu:

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

Di Alpine Linux, jalankan apk add libstdc++ libgcc sebelum menginstal.

Unduh secara manual

Setiap rilis memiliki satu file per komputer:

Komputer	File
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. Unduh file Anda dari rilis terbaru. File dilampirkan beberapa menit setelah rilis diterbitkan. Jika file Anda belum tercantum, tunggu dan muat ulang, atau ambil dari rilis sebelumnya.
2. Ekstrak file tersebut. Di terminal Anda: tar -xzf openspec-darwin-arm64.tar.gz. Di Windows, klik kanan .zip dan pilih Extract All.
3. Di macOS, jalankan xattr -d com.apple.quarantine openspec di folder tempat Anda mengekstrak. macOS memblokir file yang diunduh di browser sampai Anda melakukannya.
4. Pindahkan openspec ke folder di PATH Anda, seperti ~/.local/bin. Di Windows, pindahkan openspec.exe ke folder di PATH pengguna Anda, seperti %LOCALAPPDATA%\Programs\openspec.

Verifikasi unduhan

Untuk memeriksa bahwa file dibuat oleh alur kerja rilis OpenSpec, jalankan ini dengan GitHub CLI:

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

Ini gagal jika alur kerja tidak membuat file tersebut. Perintah instalasi sudah memeriksa setiap unduhan terhadap SHA256SUMS rilis, jadi langkah ini opsional.

Beralih dari npm ke instalasi mandiri

Beralih itu opsional; npm tetap berfungsi. Pengaturan dan proyek Anda terbawa; hanya programnya yang berubah.

1. Instal salinan mandiri. Di terminal Anda:

openspec install

Ini menginstal openspec mandiri dan mencetak perintah yang menghapus salinan npm atau Homebrew Anda.

2. Hapus salinan lama. Biasanya salinan lama berada lebih dulu di PATH Anda, jadi sampai dihapus, salinan itu terus berjalan. Jalankan perintah yang dicetak langkah 1, misalnya:

npm uninstall -g @fission-ai/openspec

3. Periksa salinan mana yang berjalan. Buka terminal baru:

openspec version

Ini harus mencetak OpenSpec <version> (standalone). Jika menyebutkan pengelola paket sebagai gantinya, salinan lain masih ada di PATH Anda: which -a openspec (Windows: where.exe openspec) mencantumkan setiap salinan, jadi hapus yang lain.

Tidak ada proyek yang perlu diinisialisasi ulang. Untuk kembali, hapus file dan jalankan instalasi npm lagi.

Memperbarui

Di terminal Anda, di setiap proyek tempat Anda menjalankan init:

openspec update

Ketika CLI yang lebih baru tersedia, openspec update memberi tahu dan dapat menginstalnya untuk Anda; peningkatan itu sekali per mesin. Setiap run menyegarkan skill dan perintah yang dibuat proyek, yang tidak pernah diperbarui sendiri. Proyek yang mutakhir mencetak ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

Dengan instalasi mandiri, jalankan openspec install untuk mengganti salinan Anda di tempat; openspec update memberi tahu Anda saat versi yang lebih baru tersedia. Di Homebrew, jalankan brew upgrade openspec. Di Deno, jalankan kembali instalasi Deno dengan -f; tanpa itu, perintah yang terinstal tidak akan ditimpa. Di Nix, gunakan nix profile upgrade openspec.

NOTE

Instalasi npm global milik satu instalasi Node. Ganti versi Node dengan nvm dan perintah openspec tidak ikut, jadi instal lagi di bawah versi baru.

Menghapus instalasi

Untuk menghapus instalasi OpenSpec, jalankan langkah-langkah di bawah ini; tidak ada yang menyentuh kode sumber Anda. Anda juga dapat mengarahkan agen Anda ke bagian ini dan membiarkannya menangani penghapusan.

1. Hapus penyelesaian shell, jika Anda mengaturnya, selagi CLI masih bisa melakukannya. Di terminal Anda:

openspec completion uninstall

2. Hapus CLI. Untuk instalasi mandiri, hapus ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec, dan folder itu dari PATH pengguna Anda). Untuk npm, di terminal Anda:

npm uninstall -g @fission-ai/openspec

Di Homebrew: brew uninstall openspec. Di Deno: deno uninstall --global openspec. Di Nix: nix profile remove openspec. Shell Anda seharusnya tidak lagi menemukan openspec.

3. Hapus yang tersisa, atau simpan.

• File agen yang dibuat: skill openspec-* dan perintah opsx di direktori seperti .claude/ atau .agents/, per proyek. Alat yang didukung mencantumkan jalur setiap alat; MiniMax Code menyimpan skill di ~/.minimax/skills.
• Sisa dari versi lama: blok penanda di CLAUDE.md atau AGENTS.md (hapus bloknya, simpan filenya) dan prompt opsx-*.md di ~/.codex/prompts.
• Folder openspec/: berhenti sejenak dulu. specs/ dan changes/archive/ adalah catatan sistem Anda, Markdown polos yang tetap terbaca tanpa OpenSpec.
• Status per mesin: pengaturan dan id telemetri di ~/.config/openspec/; override skema, registrasi store, dan skema bawaan instalasi mandiri (binary-schemas/) di ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). Registrasi adalah penunjuk; repo store yang ditunjuk tidak disentuh.