@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Build & Release (Windows)
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust (stable)
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust build artifacts
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: src-tauri
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install frontend dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build and create GitHub release
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tauriScript: bun run tauri
+          tagName: ${{ github.ref_name }}
+          releaseName: SessionHub ${{ github.ref_name }}
+          releaseBody: |
+            完整變更內容請見 [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md)。
+
+            下載下方的 `.msi` 或 `-setup.exe` 安裝檔即可安裝。
+          releaseDraft: true
+          prerelease: false
@@ -0,0 +1,34 @@
+# Changelog
+
+本專案的所有重要變更都記錄在此檔案。
+
+格式依循 [Keep a Changelog](https://keepachangelog.com/zh-TW/1.1.0/)，版本號依循 [Semantic Versioning](https://semver.org/lang/zh-TW/)。
+
+每個版本的變更分為以下類別（沒有內容的類別可省略）：
+
+- **新增**：全新的功能
+- **調整**：既有功能的行為變更、重構或體驗改進
+- **修正**：錯誤修復
+- **移除**：被拿掉的功能
+
+## [Unreleased]
+
+## [0.1.6] - 2026-07-12
+
+首個公開發布版本。SessionHub 是一個 Windows 桌面應用程式，統一管理多家 AI coding 工具的 sessions、用量配額與 hook 整合。
+
+### 新增
+
+- 多 provider session 管理：支援 GitHub Copilot CLI、OpenCode、Codex、Claude Code、Antigravity (Google Gemini) 五種 provider 的 session 掃描、搜尋、標籤、封存與刪除
+- 用量配額監控（quota）：底部狀態列 SVG 圓環即時顯示、Dashboard 依模型群組（Gemini / Claude & GPT）分組顯示、系統匣 quota widget
+- Hook 整合管理：一鍵安裝／偵測／解除安裝各 provider 的 SessionHub 事件橋接 hook，驅動即時狀態更新
+- MCP 設定管理介面：GUI 檢視與編輯多平台 MCP server 設定
+- Agents 設定管理：AGENTS.md / CLAUDE.md 雙檔源狀態徽章、Skills 與 Commands 瀏覽、設定搜尋
+- Plans & Specs 瀏覽：檢視專案內 OpenSpec 變更（含 archive）與規格節點
+- Session 統計分析：token 用量、工具呼叫、互動次數等圖表（SQLite 快取）
+- 通知：agent 等待介入通知、session 結束通知
+- 多語系介面（繁體中文／English）
+- Minimal UI 設計系統：統一 design token、玻璃浮層、Linear 式分頁、自訂 scrollbar、`prefers-reduced-motion` 支援
+
+[Unreleased]: https://github.com/chingleel17/SessionHub/compare/v0.1.6...HEAD
+[0.1.6]: https://github.com/chingleel17/SessionHub/releases/tag/v0.1.6
@@ -1,51 +1,78 @@
 # SessionHub
 
-> 一個 Windows 桌面應用程式，讓你輕鬆管理所有 GitHub Copilot CLI 的 Session。
+> 一個 Windows 桌面應用程式，統一管理 GitHub Copilot CLI、OpenCode、Codex、Claude Code、Antigravity（Google Gemini）等多家 AI coding 工具的 Session。
 
-![Version](https://img.shields.io/badge/version-0.1.0-blue)
+![Version](https://img.shields.io/badge/version-0.1.6-blue)
 ![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)
-![Stack](https://img.shields.io/badge/stack-Tauri%202%20%2B%20React%20%2B%20Rust-orange)
+![Stack](https://img.shields.io/badge/stack-Tauri%202%20%2B%20React%2019%20%2B%20Rust-orange)
 
 ---
 
 ## 為什麼需要這個工具？
 
-使用 GitHub Copilot CLI 一段時間後，`~/.copilot/session-state/` 目錄下會累積大量 session 資料夾。這些 session 分散在不同專案之間，既沒有統一的檢視介面，也沒有方法快速回到某個 session 繼續工作。
+使用多種 AI coding CLI/IDE（GitHub Copilot CLI、OpenCode、Codex、Claude Code、Antigravity）一段時間後，各家工具會在各自的資料目錄下累積大量 session 資料。這些 session 分散在不同工具與不同專案之間，既沒有統一的檢視介面，也很難掌握每家工具的用量配額還剩多少。
 
 **SessionHub 解決了以下問題：**
 
-- 無法一覽所有 session 及其對應專案
-- 不知道哪些 session 有進行中的 `plan.md` 計畫
-- 每次要重新開啟 session 都需要手動複製指令
-- Session 越來越多卻沒有封存或刪除的管理方式
+- 無法一覽所有工具、所有專案的 session
+- 不知道各家 provider 的用量配額（quota）還剩多少、何時重置
+- 不知道哪些 session 有進行中的 `plan.md` 計畫或 OpenSpec 變更
+- 每次要重新開啟 session 都需要手動查指令、切終端
+- Session 越來越多卻沒有統一的封存、標籤、統計方式
+- 各專案的 AGENTS.md / CLAUDE.md / Skills / MCP 設定要手動比對是否同步
+
+---
+
+## 支援的 Provider
+
+| Provider | 說明 |
+| --- | --- |
+| **GitHub Copilot CLI** | 掃描 `~/.copilot/session-state/`，支援 session 讀取、hook 整合 |
+| **OpenCode** | 掃描 session/message/part 目錄，支援統計指標與 hook 整合 |
+| **Codex** | 掃描 session 資料，支援 hook 整合與信任狀態偵測（codex trust） |
+| **Claude Code** | 掃描 `~/.claude/`，支援 hook 整合、用量配額監控 |
+| **Antigravity（Google Gemini）** | 掃描 `~/.gemini/` brain roots，透過本機 language server RPC 取得用量配額 |
+
+各 provider 皆可在設定頁個別啟用/停用，並各自設定資料根目錄。
 
 ---
 
 ## 主要功能
 
-| 功能                    | 說明                                                                   |
-| ----------------------- | ---------------------------------------------------------------------- |
-| **Session 列表**        | 掃描並列出所有 Copilot session，顯示專案路徑、摘要、建立時間、更新時間 |
-| **依專案分頁**          | 每個專案（cwd）開啟獨立分頁，方便跨專案切換                            |
-| **搜尋與篩選**          | 關鍵字搜尋、標籤多選篩選、排序（時間／名稱）                           |
-| **Dashboard**           | 統計總覽：session 數量、近期活動、專案分佈                             |
-| **一鍵開啟終端**        | 直接以指定終端（pwsh/PowerShell）在 session 的工作目錄開啟             |
-| **複製 Session 指令**   | 一鍵複製重新進入該 session 的 Copilot 指令                             |
-| **封存／刪除**          | 封存不再需要的 session，或永久刪除                                     |
-| **Plan 編輯器**         | 在 app 內查看、編輯 `plan.md`，支援 Markdown 預覽                      |
-| **外部編輯器開啟 Plan** | 以 VSCode 或自訂編輯器開啟 `plan.md`                                   |
-| **即時更新**            | 監聽 session-state 目錄，新增或修改時自動刷新列表                      |
-| **備註與標籤**          | 為每個 session 加入個人備註與標籤，存於本地資料庫                      |
-| **多語系**              | 支援繁體中文介面                                                       |
-| **Claude Hook 整合**    | 安裝 Claude Code hooks 並將事件寫入 SessionHub bridge                 |
+| 功能 | 說明 |
+| --- | --- |
+| **多 Provider Session 掃描** | 同時掃描並列出五種 provider 的 session，顯示專案路徑、Git 分支、摘要、建立/更新時間 |
+| **依專案分頁** | 每個專案（cwd）開啟獨立分頁，方便跨專案、跨 provider 切換 |
+| **搜尋與篩選** | 關鍵字搜尋、標籤多選篩選、專案釘選、排序（時間／名稱） |
+| **Dashboard** | 統計總覽、看板（Kanban）檢視 session 進行狀態（進行中/等待回應/閒置/已完成）、活動圖表 |
+| **Session 統計分析** | Token 用量、花費、互動次數等分析圖表，可依週/月切換 |
+| **用量配額監控（Quota）** | 狀態列圓環顯示即時用量百分比（變色警示），Dashboard 依模型群組分組顯示各 provider 配額視窗與重置時間 |
+| **Hook 整合** | 一鍵安裝／偵測／解除安裝各 provider 的事件 hook（bridge），支援 targeted 局部刷新與原生通知 |
+| **通知** | Agent 需要介入時、session 結束時跳出系統通知 |
+| **系統匣（Tray）** | 可最小化至系統匣背景執行 |
+| **MCP 設定管理** | GUI 新增/編輯/刪除/啟停用各平台的 MCP Server 設定（HTTP/SSE、npx、本機執行檔、自訂 JSON） |
+| **Agents 設定管理** | 管理 AGENTS.md／CLAUDE.md 雙檔源、Skills、Commands，顯示各平台載入/同步狀態並可一鍵同步 |
+| **Plans & Specs 瀏覽** | 瀏覽專案內 OpenSpec 變更（active/archived）、規格與 `.sisyphus` 計畫/筆記/證據，支援 Tree/List/Cols 檢視模式 |
+| **一鍵開啟終端** | 直接以指定終端（pwsh/PowerShell）在 session 的工作目錄開啟 |
+| **複製 Session 指令** | 一鍵複製依 provider 對應的重新進入指令 |
+| **封存／刪除** | 封存不再需要的 session，或永久刪除 |
+| **Plan 編輯器** | 在 app 內查看、編輯 `plan.md`，支援 Markdown 預覽；亦可用外部編輯器開啟 |
+| **即時更新** | 監聽各 provider 的 session 目錄與 hook 事件，新增或修改時自動刷新列表 |
+| **備註與標籤** | 為每個 session 加入個人備註與標籤，存於本地資料庫 |
+| **多語系** | 支援繁體中文、English 介面切換 |
 
 ---
 
 ## 系統需求
 
 - **作業系統**：Windows 10 / 11（x64）
-- **GitHub Copilot CLI** 已安裝，session-state 路徑為 `~/.copilot/session-state/`（可自訂）
 - **終端機**：PowerShell 7（pwsh）或 Windows PowerShell
+- 至少安裝並使用過以下其中一種工具，才有 session 可供管理：
+  - GitHub Copilot CLI
+  - OpenCode
+  - Codex CLI
+  - Claude Code
+  - Antigravity（Google Gemini）
 
 ---
 
@@ -81,43 +108,52 @@ bun run tauri build
 
 ```
 src-tauri/target/release/bundle/
-  msi/    → SessionHub_0.1.0_x64_en-US.msi
-  nsis/   → SessionHub_0.1.0_x64-setup.exe
+  msi/    → SessionHub_0.1.6_x64_en-US.msi
+  nsis/   → SessionHub_0.1.6_x64-setup.exe
 ```
 
 ---
 
 ## 首次設定
 
 1. 開啟應用程式後，前往左側 Sidebar 的「**設定**」
-2. 確認 **Copilot 路徑**（預設 `~/.copilot`）是否正確
+2. 在「Provider」區塊啟用需要的工具，並確認各自的資料根目錄（例如 Copilot 根目錄、Claude Code 資料目錄、Antigravity 根目錄等）是否正確
 3. 設定**終端機路徑**（點擊「自動偵測」讓 app 自動找到 pwsh/PowerShell）
 4. 選填**外部編輯器路徑**（用於開啟 plan.md，點擊「偵測 VSCode」自動填入）
-5. 儲存設定，回到主頁即可看到所有 session
+5. 依需求開啟用量配額監控、通知、系統匣最小化等選項
+6. 儲存設定，回到主頁即可看到所有 session
 
 ---
 
 ## 使用說明
 
 ### 查看所有 Session
 
-- 主頁（Dashboard）顯示統計資訊與最近活動
-- 點擊左側 Sidebar 的「**Sessions**」進入完整列表
+- 主頁（Dashboard）顯示統計資訊、看板檢視與最近活動
+- 點擊左側 Sidebar 的專案分頁進入完整列表
 - 使用頂部搜尋列過濾，或點選標籤篩選
 
 ### 開啟 Session
 
 選擇任一 session，點擊：
 
-- 🖥 **開啟終端**：在該專案目錄開啟終端機
-- 📋 **複製指令**：複製 `gh copilot session <id>` 指令，貼到任何終端執行
+- **開啟終端**：在該專案目錄開啟終端機
+- **複製指令**：複製對應 provider 的 session 重新進入指令，貼到任何終端執行
+
+### 管理 Plan 與 OpenSpec
+
+- Session 卡片上若含 `plan.md`，可展開 **Plan 編輯器** 直接在 app 內查看與編輯，或以外部編輯器開啟
+- 「Plans & Specs」頁籤可瀏覽專案的 OpenSpec 變更與規格、`.sisyphus` 計畫資料
+
+### 管理 Agents 設定
 
-### 管理 Plan
+- 「Agents」頁籤可檢視/編輯 AGENTS.md、CLAUDE.md、Skills、Commands、MCP 設定
+- 顯示各平台的載入/同步狀態（一致／需同步／未安裝），可一鍵套用同步
 
-Session 卡片上若有 📄 圖示，代表該 session 包含 `plan.md`：
+### 監控用量配額
 
-- 點擊 session 展開 **Plan 編輯器**，可直接在 app 內查看與編輯
-- 點擊「**外部開啟**」以 VSCode 或指定編輯器開啟
+- 狀態列圓環會即時顯示目前 provider 的用量百分比並依用量變色
+- Dashboard 的用量面板依模型群組分組顯示各配額視窗、剩餘額度與重置時間
 
 ### 封存與刪除
 
@@ -128,22 +164,26 @@ Session 卡片上若有 📄 圖示，代表該 session 包含 `plan.md`：
 
 ## 資料存放位置
 
-| 資料                 | 路徑                                  |
-| -------------------- | ------------------------------------- |
-| 應用程式設定         | `%APPDATA%\SessionHub\settings.json`  |
-| 備註與標籤（SQLite） | `%APPDATA%\SessionHub\metadata.db`    |
-| Claude Hook 腳本     | `%APPDATA%\SessionHub\.claude\hooks\` |
-| Copilot Sessions     | `~/.copilot/session-state/`（可自訂） |
+| 資料 | 路徑 |
+| --- | --- |
+| 應用程式設定 | `%APPDATA%\SessionHub\settings.json` |
+| 備註與標籤／快取（SQLite） | `%APPDATA%\SessionHub\metadata.db` |
+| Hook 腳本 | `%APPDATA%\SessionHub\.claude\hooks\`（及各 provider 對應目錄） |
+| GitHub Copilot CLI Sessions | `~/.copilot/session-state/`（可自訂） |
+| OpenCode Sessions | `<root>/session|message|part/`（可自訂） |
+| Codex Sessions | Codex 資料目錄（可自訂） |
+| Claude Code Sessions | `~/.claude/`（可自訂） |
+| Antigravity Sessions | `~/.gemini/`（brain roots + `agyhub_summaries_proto.pb`，可自訂） |
 
 ---
 
 ## 技術棧
 
-- **前端**：React 18 + TypeScript + Vite + React Query
+- **前端**：React 19 + TypeScript + Vite + React Query
 - **後端**：Rust + Tauri 2
 - **資料庫**：SQLite（rusqlite，bundled）
-- **即時監控**：notify crate（filesystem watcher）
-- **UI**：純 CSS（無 CSS 框架）
+- **即時監控**：notify crate（filesystem watcher）+ 各 provider hook bridge
+- **UI**：純 CSS（無 CSS 框架），統一設計 token（圓角/邊框/陰影/玻璃/動畫）
 
 ---
 
 
@@ -1,7 +1,7 @@
 {
   "name": "session-hub",
   "private": true,
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "scripts": {
     "dev": "vite",
 
@@ -0,0 +1,65 @@
+# SessionHub 發布腳本
+# 用法: .\scripts\release.ps1 -Version 0.1.7
+#
+# 流程:
+#   1. 檢查工作區乾淨、位於 main 分支
+#   2. 更新 package.json / Cargo.toml / Cargo.lock 版本號
+#   3. 檢查 CHANGELOG.md 已有該版本的段落（沒有就中止，先寫 changelog）
+#   4. commit + 建立 tag vX.Y.Z + push
+#   5. GitHub Actions (release.yml) 會自動建置安裝檔並建立 draft release
+#   6. 到 GitHub Releases 頁面檢查後按 Publish
+
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidatePattern('^\d+\.\d+\.\d+$')]
+    [string]$Version
+)
+
+$ErrorActionPreference = "Stop"
+$repoRoot = Split-Path -Parent $PSScriptRoot
+Set-Location $repoRoot
+
+# 1. 前置檢查
+$branch = git rev-parse --abbrev-ref HEAD
+if ($branch -ne "main") { throw "目前在 '$branch' 分支，請切到 main 再發布" }
+
+$dirty = git status --porcelain
+if ($dirty) { throw "工作區有未提交的變更，請先 commit 或 stash:`n$dirty" }
+
+$tag = "v$Version"
+if (git tag -l $tag) { throw "tag $tag 已存在" }
+
+# 2. 檢查 CHANGELOG 已有該版本段落
+$changelog = Get-Content "CHANGELOG.md" -Raw
+if ($changelog -notmatch [regex]::Escape("## [$Version]")) {
+    throw "CHANGELOG.md 中找不到 '## [$Version]' 段落，請先撰寫該版本的變更內容（新增/調整/修正/移除）"
+}
+
+# 3. 更新版本號
+Write-Host "更新版本號至 $Version ..." -ForegroundColor Cyan
+
+$pkg = Get-Content "package.json" -Raw
+$pkg = $pkg -replace '"version":\s*"[\d.]+"', "`"version`": `"$Version`""
+Set-Content "package.json" $pkg -NoNewline
+
+$cargo = Get-Content "src-tauri/Cargo.toml" -Raw
+$cargo = $cargo -replace '(?m)^version\s*=\s*"[\d.]+"', "version = `"$Version`""
+Set-Content "src-tauri/Cargo.toml" $cargo -NoNewline
+
+Push-Location src-tauri
+cargo update -p session-hub --offline | Out-Null
+Pop-Location
+
+# 4. commit + tag + push
+Write-Host "建立 commit 與 tag $tag ..." -ForegroundColor Cyan
+git add package.json src-tauri/Cargo.toml src-tauri/Cargo.lock CHANGELOG.md
+git commit -m "chore: release $tag"
+git tag $tag
+git push origin main
+git push origin $tag
+
+Write-Host ""
+Write-Host "完成！GitHub Actions 正在建置安裝檔。" -ForegroundColor Green
+Write-Host "建置完成後會產生 draft release，請到以下網址檢查並按 Publish：" -ForegroundColor Green
+Write-Host "  https://github.com/chingleel17/SessionHub/releases" -ForegroundColor Yellow
+Write-Host "查看建置進度： gh run watch" -ForegroundColor Yellow
@@ -1,7 +1,7 @@
 [package]
 name = "session-hub"
-version = "0.1.5"
-description = "Windows desktop app for managing GitHub Copilot CLI sessions"
+version = "0.1.6"
+description = "Windows desktop app for managing AI coding CLI sessions (Copilot, OpenCode, Codex, Claude, Antigravity)"
 authors = ["ching"]
 edition = "2021"
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "session-hub",`
`3`	`3`	`"private": true,`
`4`		`- "version": "0.1.5",`
	`4`	`+ "version": "0.1.6",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`
`7`	`7`	`"dev": "vite",`