Persistent AI Memory · Open Source Persistent AI Memory · Open Source Beta · v0.3.6

你的 AI 每次都失憶。 Your AI forgets everything.

這個工具解決它。 This fixes it.

所有 AI 開發工具共用一個持久記憶層。 Persistent memory for every AI coding tool.

$ pipx install vibe-state-cli

在 GitHub 上查看GitHub → 使用文件 → Documentation →

MIT 授權 · 230 項測試 · 96% 覆蓋率MIT License · 230 tests · 96% coverage

問題出在哪？ The problem.

每一個 AI 開發者都在重複這些痛苦。 Every AI-assisted developer hits the same walls.

對話失憶 Session Amnesia

你花兩小時跟 Claude 解釋架構。關掉終端，明天它什麼都不記得。 You spend 2 hours explaining your architecture to Claude. Close the terminal. Tomorrow it remembers nothing.

工具孤島 Tool Silos

在 Cursor 修完 bug，切到 Claude Code 做重構——Claude 不知道你剛做了什麼。 Fix a bug in Cursor, switch to Claude Code for refactoring — Claude has no idea what you just did.

規範散落 Rule Duplication

CLAUDE.md、.cursorrules、AGENTS.md——三份說一樣的話，全在吃 token。 CLAUDE.md, .cursorrules, AGENTS.md — three files saying the same thing, all eating tokens.

所有 AI 工具共用一個大腦。 One shared brain for all your AI tools.

一個 .vibe/ 目錄，統一所有工具的狀態。 A single .vibe/ directory that unifies state across every tool.

.vibe/
├── config.toml
└── state/
    ├── current.md
    ├── tasks.md
    ├── standards.md
    └── experiments.md

Claude Code Cursor Windsurf Cline Roo Code GitHub Copilot Gemini CLI → Antigravity CLI AGENTS.md

註：Google 將於 2026-06-18 將 Gemini CLI 改名為 Antigravity CLI — vibe-state-cli 已先支援。 Note: Google retires Gemini CLI on 2026-06-18 in favor of Antigravity CLI — vibe-state-cli already supports both.

初始化後，跟 AI 說就好。 After init, just talk to your AI.

只有 vibe init 需要在終端打字。之後所有操作都透過 AI 對話完成——跟 AI 說「vibe start」，它就會幫你執行。 Only vibe init requires the terminal. After that, just tell your AI "vibe start" or "vibe sync" — it knows these are terminal commands and runs them for you.

你跟 AI 說： You tell AI: "vibe start" → AI 自動執行，載入你的進度 AI runs it, loads your progress

vibe init

掃描專案，偵測工具，建立 .vibe/ Scan project, detect tools, set up .vibe/

v0.3.6 ✦ 自動裝好「commit 完自動同步」功能，從此每次 commit 後進度就會自己更新。 Now automatically wires up "auto-sync after commit" — every commit updates your progress without you doing anything.

vibe start

開始工作——AI 看到最新進度 Begin session — AI sees latest progress

v0.3.6 ✦ 開工時自動補上昨天還沒同步的進度，不用再記得手動跑同步指令。 Now auto-catches-up any progress you forgot to sync yesterday — no need to remember to run sync first.

vibe sync

結束工作——從 git 儲存進度 End session — save today's work from git

v0.3.6 ✦ 可以加 --note 留下「為什麼這樣做」的理由，未來換工具或下次 session 都看得到。 Add --note to record the "why" behind a decision — future sessions and other AI tools see it too.

vibe status

隨時查看狀態 Check state anytime

v0.3.6 ✦ 變成健康儀表板——一眼看出「上次同步多久前、落後幾個 commit、哪個工具設定過期」。 Now a health dashboard — see at a glance "how long since last sync, how many commits behind, which tool config is stale."

vibe adapt

增減 AI 工具支援 Add or remove AI tool support

v0.3.6 ✦ 多了 --lang，可以隨時切換中英文介面。 Now supports --lang to switch the interface between English and Traditional Chinese on the fly.

8 個 Adapter 支援矩陣 8 Adapter Support Matrix

工具Tool	vibe 產生的檔案What vibe generates	同步深度Sync depth
Claude Code	CLAUDE.md + .claude/rules/ + 5 slash commands	完整狀態（@import）Full state via @import
Cursor	.cursor/rules/vibe-standards.mdc	規範 + 摘要內嵌Standards + summary inline
Windsurf	.windsurf/rules/vibe-standards.md	規範 + 摘要內嵌Standards + summary inline
Cline	.clinerules/01-vibe-standards.md	規範 + 摘要內嵌Standards + summary inline
Roo Code	.roo/rules/01-vibe-standards.md	規範 + 摘要內嵌Standards + summary inline
GitHub Copilot	.github/copilot-instructions.md	僅摘要Summary only
Gemini CLI / Antigravity CLI	GEMINI.md（過渡至 2026-06-18）+ .agents/skills/ GEMINI.md (transitional thru 2026-06-18) + .agents/skills/	完整狀態（@import）Full state via @import
AGENTS.md	AGENTS.md（跨工具標準）AGENTS.md (cross-tool standard)	完整 — 唯一真實來源Full — single source of truth

AGENTS.md — Linux Foundation 標準（2025-12 認可 · 60,000+ repos 採用） AGENTS.md — Linux Foundation Standard (ratified 2025-12 · 60,000+ repos)

v0.3.6 起，AGENTS.md 是配置的單一真實來源（Agentic AI Foundation 標準）。Cursor / Windsurf / Cline / Roo / Copilot 改用 shim 指向它 — 同樣的內容，少一倍維護成本。 Since v0.3.6, AGENTS.md is the single source of truth for tool configs (Agentic AI Foundation standard). Cursor / Windsurf / Cline / Roo / Copilot now shim to it — same content, half the maintenance.

v0.3.6 ✦ STABLE

從「記得用」變成「自動會用」 From "remember to use it" to "it just runs"

之前的版本，你需要記得每天收工時跑 vibe sync。如果忘記，AI 隔天就看不到昨天做了什麼。v0.3.6 解決這個問題，且已穩定 Beta。 Earlier versions assumed you'd remember to run vibe sync at the end of each day. Forget once, and your AI starts the next session blind to yesterday's work. v0.3.6 fixes that — now stable Beta.

🔄

自動同步 Auto-sync

安裝後 git 會幫你跑同步。每次 commit 後，進度自動更新——你不用再記得任何指令。 After install, git runs the sync for you. Every commit updates your progress automatically — nothing for you to remember.

🩺

健康儀表板 Health dashboard

跑 vibe status 不再只是看狀態。它會直接告訴你： vibe status isn't just a state check anymore. It tells you straight up:

「上次同步：30 天前」"Last sync: 30 days ago"

「落後 48 個 commit ⚠️」"48 commits behind ⚠️"

📝

留下「為什麼」 Capture the "why"

Git commit 通常只說「做了什麼」。同步時加一句 --note 就能也記下「為什麼」，未來換工具或新 session 都看得到。 Git commits only say "what changed." Add a --note while syncing to capture the "why" — future sessions and other AI tools see it too.

vibe sync --note "理由是 token 效率because of token efficiency"

🌐

中英文隨時切換 Switch language anytime

不喜歡英文介面？跑這行，立刻變中文： Prefer Traditional Chinese? Run this and the interface flips:

vibe adapt --lang zh-TW

v0.3.6（2026-06-07） — Alpha → Beta v0.3.6 (2026-06-07) — Alpha → Beta

awareness loop 在 60 天內被 11 個 dogfood 專案實戰使用，0 個外部回報的 bug。PyPI Development Status 正式從 Alpha 升至 Beta — 過了原型階段、穩定生產可用。舊專案不用做任何事，下次 vibe start 會自動升級設定。 The awareness loop ran across 11 dogfood projects for 60 days with zero externally-reported bugs. PyPI Development Status is now officially Beta — past prototype, stable for production. Existing projects auto-upgrade on the next vibe start — no action needed.

不做什麼 What it does NOT do

不呼叫任何 API。 No API calls. 完全離線，沒有遙測，沒有網路。 Fully offline. No telemetry. No network.

不碰你的 git。 Never touches your git. 只讀取，不會 commit 或 push。 Read-only. No commits. No pushes.

不綁架你。 No lock-in. .vibe/ 是純 Markdown，隨時刪掉就好。 .vibe/ is plain Markdown. Delete it anytime.

不改變你的工作方式。 No workflow change. 你還是用原本的方式跟 AI 對話。vibe 只是確保 AI 記得。 Keep talking to your AI as usual. vibe just makes sure it remembers.

公開建造。連教訓一起。 Built in public. Lessons included.

真實的開發故事，不是行銷文案。 Real stories from the build, not marketing copy.

Round 2 — Hallucination Audit

4 個 Agent 同時產生幻覺 4 AI agents, 4 hallucinations

我們派 4 個 Agent 同時研究 8 個工具。一半的結論是錯的——Claude 不讀 AGENTS.md、.cursorrules 已棄用、MCP「v1.27」是 SDK 版本不是協議版本。教訓：AI 研究結果必須交叉驗證。 We sent 4 AI agents to research 8 tools simultaneously. Half the findings were wrong — Claude doesn't read AGENTS.md, .cursorrules is deprecated, MCP "v1.27" was the SDK version not the protocol. Lesson: AI research must be cross-verified.

幻覺：Hallucination: "Claude reads AGENTS.md natively"

真實：Reality: Claude only reads CLAUDE.md + .claude/rules/

Post-launch — The Wild

AI 越界修改了另一個專案的程式碼 AI crossed the project boundary

在另一個專案跑 vibe sync 碰到 Windows 編碼 bug。AI 找到 D 槽的開發原始碼直接改了——越過了專案邊界。根因：subprocess.run() 沒指定 encoding="utf-8"。 Running vibe sync in a different project hit a Windows encoding bug. The AI found our source code on D: drive and modified it directly — crossing the project boundary. Root cause: subprocess.run() without explicit encoding="utf-8".

v0.3.0 — Senior Review

最犀利的批評不在程式碼裡 "best-effort, ~40-60%"

資深工程師指出文件讓使用者期望超過現實。AI checkpoint 遵從率約 40-60%，Copilot 無法讀 state 檔案。工具最大的風險不在程式碼裡，在使用者的誤解。 Senior engineers (30 years experience) pointed out that our docs made users expect more than reality. AI checkpoint compliance is ~40-60%. Copilot can't read state files. The biggest risk isn't in the code — it's in users' expectations.

v0.3.0 — One Day

一天內從「能用」到「工業級」 From "works" to "industrial grade" in 24 hours

2 輪紅軍審查 + 2 位資深工程師。砍掉 6 個過度設計（指紋、快照、指數退避鎖）。找到修復 11 個安全問題。教訓：複雜度本身就是風險。 2 red-team reviews + 2 senior engineers. Cut 6 over-engineered features (fingerprint, snapshot, exponential backoff locks). Found and fixed 11 security issues. Lesson: complexity itself is risk.

v0.3.3 — Real World

「command not found」才是大多數人會遇到的 "command not found" is the happy path

在真實專案測試 vibe init，IDE 終端找不到 vibe 指令——因為 pipx ensurepath 只對新開的終端視窗生效。不是 bug，但對新手來說「command not found」就是「壞了」。修正：重寫 README，假設讀者從未用過 pipx。 Tested vibe init in a real project. The IDE terminal couldn't find the vibe command — because pipx ensurepath only updates PATH for new terminal windows. Not a bug, but for first-time users, "command not found" means "it's broken." Fix: redesigned the README to assume the reader has never used pipx.

v0.3.6 — Beta

awareness loop 撐過 60 天 dogfood 才升 Beta Awareness loop earned its way to Beta

前一版引入的 awareness loop（自動同步、開工自動補進度、健康儀表板）跨 11 個 dogfood 專案實戰 60 天，沒有任何外部回報的 bug — 這才有信心升 Beta。 The awareness loop — auto-sync, session catch-up, health dashboard — ran across 11 dogfood projects for 60 days with zero externally-reported bugs. That's the bar we set for going Beta.

230

自動化測試Automated Tests

96%

測試覆蓋率Test Coverage

安全審查輪次Security Review Rounds

2,800

行程式碼Lines of Code

2 輪紅軍審查 · 2 位資深工程師（30 年經驗） · 從 v0.1 演進至 v0.3.6 Beta2 red-team reviews · 2 senior engineers (30 years experience) · evolved from v0.1 to v0.3.6 Beta

2 分鐘安裝，之後不用再碰終端。 2 minutes to install. Then never touch the terminal again.

安裝（全電腦一次，之後不用管） Install (once per machine, then forget about it)

$ pip install pipx $ pipx ensurepath $ pipx install vibe-state-cli

⚠️ 跑完後，關掉終端和 IDE，重新開。新的 PATH 只在重啟後生效。 ⚠️ After running, close and reopen your terminal and IDE. New PATH only takes effect after restart.

初始化專案（每個專案一次） Initialize project (once per project)

$ cd your-project $ vibe init --lang zh-TW

它會掃描專案、建立 .vibe/、幫每個 AI 工具生成設定檔。已有的 CLAUDE.md 或 .cursorrules 會被安全匯入並歸檔。 It scans your project, creates .vibe/, and generates config files for each AI tool. Existing CLAUDE.md or .cursorrules are safely imported and archived.

日常使用——跟 AI 說就好 Daily use — just talk to your AI

💡 v0.3.6 起更省事 💡 v0.3.6 makes it even easier

你連「vibe sync」都不用主動講了。每次你 commit，vibe 會自動幫你同步進度。日常你只需要：早上開工跟 AI 說「vibe start」、想知道狀態跟 AI 說「vibe status」。 You don't even need to ask for "vibe sync" anymore — vibe syncs your progress automatically after every commit. Day to day you just say "vibe start" in the morning and "vibe status" when you want to check in.

開工Start 跟 AI 說Tell AI "vibe start"

查狀態Check 跟 AI 說Tell AI "vibe status"

收工End commit 後自動同步——什麼都不用做 auto-syncs after commit — nothing to do

💡 如果 AI 說「command not found」怎麼辦？ 💡 What if AI says "command not found"?

不用擔心。AI 會自動改成直接讀你的 .vibe/state/ 檔案，一樣能拿到所有上下文。這是設計好的。 Don't worry. The AI will automatically fall back to reading your .vibe/state/ files directly. Same context, just a different path. This is by design.

讓你的 AI 有記憶。 Give your AI a memory.

開源、免費、MIT 授權。 Open source, free, MIT licensed.

在 GitHub 上 StarStar on GitHub 回到 LIYON 官網Back to LIYON Global

預約 30 分鐘免費諮詢Book a 30-min Free Call

了解你的狀況，給出具體建議Understand your situation, get tailored advice

選擇時段Pick a Time

寄送 EmailSend Email

liyon.global[at]gmail.com

發送郵件Send Email

直接來電Call Us

週一至週五 9:00-18:00Mon–Fri 9:00–18:00

03-3558665 #103