การติดตั้ง

ติดตั้ง openspec CLI บนเครื่องของคุณ อัปเดต และถอนการติดตั้ง

ติดตั้ง

บน 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.

หรือในเทอร์มินัลของคุณ ให้ pipe ข้อความนี้เข้าไปยัง CLI agent (แสดงตัวอย่างด้วย Claude Code):

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

ข้อความนั้นจะดึง install.md ที่ root ของ repo ซึ่งเป็นพรอมต์ที่เขียนไว้สำหรับ agent ใดก็ตามที่รันคำสั่งเชลล์ได้ (การผสานรวมกับ 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.js ของตัวเอง) ในเทอร์มินัลของคุณ:

node --version

หากพิมพ์ v22.12.0 หรือสูงกว่า ให้ติดตั้งด้วย npm:

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

หากไม่ใช่ ให้ติดตั้ง Node ที่ใหม่กว่าจาก nodejs.org หรือผ่านตัวจัดการเวอร์ชันของคุณ (nvm, fnm, asdf, volta) หรือใช้การติดตั้งแบบสแตนด์อโลนแทน

Homebrew

Homebrew ติดตั้ง OpenSpec และ dependency Node.js ของมันบน macOS หรือ Linux ในเทอร์มินัลของคุณ:

brew install openspec

formula นี้เผยแพร่ใน 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 ไม่สามารถ resolve @latest ได้ ให้ตรึงช่วงเวอร์ชันแทน: npm:@fission-ai/openspec@^1.7.0

Nix

repo ของ 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: release ที่จะติดตั้ง เช่น v1.15.0 ค่าเริ่มต้นคือ release ใหม่ล่าสุด
• 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 ก่อนติดตั้ง

ดาวน์โหลดด้วยตนเอง

แต่ละ release มีหนึ่งไฟล์ต่อหนึ่งเครื่อง:

เครื่อง	ไฟล์
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. ดาวน์โหลด ไฟล์ของคุณจาก release ล่าสุด ไฟล์จะถูกแนบภายในไม่กี่นาทีหลังจากเผยแพร่ release หากยังไม่แสดงไฟล์ของคุณ ให้รอและโหลดใหม่ หรือใช้ไฟล์จาก release ก่อนหน้า
2. แตกไฟล์ ในเทอร์มินัลของคุณ: tar -xzf openspec-darwin-arm64.tar.gz บน Windows ให้คลิกขวาที่ .zip แล้วเลือก Extract All
3. บน macOS ให้รัน xattr -d com.apple.quarantine openspec ในโฟลเดอร์ที่คุณแตกไฟล์ macOS จะบล็อกไฟล์ที่ดาวน์โหลดผ่านเบราว์เซอร์จนกว่าคุณจะทำขั้นตอนนี้
4. ย้าย openspec ไปยังโฟลเดอร์ที่อยู่ใน PATH ของคุณ เช่น ~/.local/bin บน Windows ให้ย้าย openspec.exe ไปยังโฟลเดอร์ที่อยู่ใน PATH ของผู้ใช้ เช่น %LOCALAPPDATA%\Programs\openspec

ตรวจสอบไฟล์ดาวน์โหลด

หากต้องการตรวจสอบว่าไฟล์ถูกสร้างโดย workflow การเผยแพร่ของ OpenSpec ให้รันคำสั่งนี้ด้วย GitHub CLI:

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

คำสั่งนี้จะล้มเหลวหากไฟล์ไม่ได้ถูกสร้างโดย workflow การเผยแพร่ คำสั่งติดตั้งตรวจสอบแต่ละไฟล์ดาวน์โหลดเทียบกับ SHA256SUMS ของ release อยู่แล้ว ดังนั้นขั้นตอนนี้จึงเป็นทางเลือก

เปลี่ยนจาก npm ไปเป็นการติดตั้งแบบสแตนด์อโลน

การสลับเป็นทางเลือก; npm ยังใช้งานได้ การตั้งค่าและโปรเจกต์ของคุณจะยังคงอยู่ มีเพียงโปรแกรมเท่านั้นที่เปลี่ยน

1. ติดตั้งสำเนาแบบสแตนด์อโลน ในเทอร์มินัลของคุณ:

openspec install

มันจะติดตั้ง standalone 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 อีกครั้ง

การอัปเดต

ในเทอร์มินัลของคุณ ในแต่ละโปรเจกต์ที่คุณรัน init:

openspec update

เมื่อมี CLI ใหม่กว่า openspec update จะแจ้งและสามารถติดตั้งให้คุณได้ การอัปเกรดนี้ทำครั้งเดียวต่อเครื่อง ทุกครั้งที่รันจะรีเฟรช skills และคำสั่งที่สร้างขึ้นของโปรเจกต์ ซึ่งจะไม่อัปเดตด้วยตัวเอง โปรเจกต์ที่เป็นปัจจุบันจะพิมพ์ ✓ All 2 tool(s) up to date (v1.7.0)

WARNING

ด้วยการติดตั้งแบบสแตนด์อโลน ให้รัน openspec install เพื่อแทนที่สำเนาของคุณในตำแหน่งเดิม openspec update จะแจ้งเมื่อมีเวอร์ชันใหม่กว่า บน Homebrew ให้รัน brew upgrade openspec บน Deno ให้รันการติดตั้ง Denoใหม่พร้อม -f; หากไม่มี -f มันจะไม่เขียนทับคำสั่งที่ติดตั้งไว้ บน Nix ให้ใช้ nix profile upgrade openspec

NOTE

การติดตั้ง npm แบบโกลบอลเป็นของการติดตั้ง Node หนึ่งรายการ หากสลับเวอร์ชัน Node ด้วย nvm คำสั่ง openspec จะไม่ตามไปด้วย ดังนั้นให้ติดตั้งใหม่ภายใต้เวอร์ชันใหม่

การถอนการติดตั้ง

หากต้องการถอนการติดตั้ง OpenSpec ให้ทำตามขั้นตอนด้านล่าง ไม่มีขั้นตอนใดแตะต้องซอร์สโค้ดของคุณ คุณยังสามารถชี้ให้ agent ของคุณมาที่ส่วนนี้และให้มันจัดการการลบได้

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. ลบสิ่งที่เหลือ หรือเก็บไว้

• ไฟล์ agent ที่สร้างขึ้น: skills openspec-* และคำสั่ง opsx ภายใต้ไดเรกทอรีเช่น .claude/ หรือ .agents/ ต่อโปรเจกต์ เครื่องมือที่รองรับ แสดงพาธของแต่ละเครื่องมือ; MiniMax Code เก็บ skills ใน ~/.minimax/skills
• สิ่งตกค้างจากเวอร์ชันเก่า: บล็อกเครื่องหมายใน CLAUDE.md หรือ AGENTS.md (ลบบล็อก แต่เก็บไฟล์ไว้) และพรอมต์ opsx-*.md ใน ~/.codex/prompts
• โฟลเดอร์ openspec/: ควรพิจารณาก่อน specs/ และ changes/archive/ คือบันทึกของระบบของคุณ เป็น Markdown ธรรมดาที่อ่านได้ดีโดยไม่ต้องใช้ OpenSpec
• สถานะต่อเครื่อง: การตั้งค่าและ telemetry id ใน ~/.config/openspec/; การแทนที่สคีมา การลงทะเบียน store และสคีมาที่มีมาในตัวของการติดตั้งแบบสแตนด์อโลน (binary-schemas/) ใน ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec) การลงทะเบียนเป็นเพียงตัวชี้; repo ของ store ที่ชี้ไปจะไม่ถูกแตะต้อง