安裝 spek

spek 讀的是含有 openspec/ 目錄的 repository。下面每一種都呈現同樣的畫面（瀏覽）；GitHub Action 則是產出靜態頁面，不在你的電腦上執行。

VS Code

從 Visual Studio Marketplace 安裝 spek — OpenSpec Viewer（Open VSX 上也有）。需要 VS Code 1.85 以上。

workspace 含有 openspec/config.yaml 時啟用。
活動列的 spek 圖示會打開側欄，列出 spec（依資料夾巢狀）與 change；點任何一項就打開完整的檢視面板。
指令：spek: Open spek、spek: Search OpenSpec、spek: Open Dashboard。
設定：

設定作用預設

spek.aggregateWorktrees 顯示 repository 所有 git worktree 的 change true

spek.aggregateJjWorkspaces 實驗性：連 jj workspace 一起顯示 false

面板上的範圍切換會寫入這兩個設定，改設定也會同步更新切換（Worktree 聚合）。

設定	作用	預設
`spek.aggregateWorktrees`	顯示 repository 所有 git worktree 的 change	`true`
`spek.aggregateJjWorkspaces`	實驗性：連 jj workspace 一起顯示	`false`

JetBrains IDE

從 JetBrains Marketplace 安裝 spek - OpenSpec Viewer，或在 Settings › Plugins › Marketplace 搜尋「spek」。支援 IntelliJ IDEA、WebStorm、PyCharm、PhpStorm、GoLand、RubyMine、CLion、Rider 等 IntelliJ 系列 IDE，2023.3 以上。

專案含有 openspec/ 目錄時啟用。
從右側欄的 spek 工具視窗打開，或選 Tools › Open spek。
IDE 有內建瀏覽器（JCEF）時直接在 IDE 裡顯示；沒有的話，改在你的預設瀏覽器打開同一個頁面。
這個外掛不做 worktree 聚合。

網頁版

網頁版從 spek 的原始碼啟動，沒有發佈成套件。需要 Node.js 22 以上與 git。

git clone https://github.com/spekhq/spek.git
cd spek
npm install
npm run dev

打開 http://localhost:5173，輸入含有 openspec/ 目錄的 repository 路徑，就能開始瀏覽。npm run dev 會在本機啟動兩個行程：port 5173 的頁面，以及它讀資料用的 port 3001 的 API（資料與網路）。

OpenSpec CLI

spek 自己讀 openspec/。如果裝了 OpenSpec CLI，spek 還會向它查詢 repository 的工作流程 schema；沒裝的話其他功能都正常，只是 spek 能呈現的 schema 資訊比較少。