Cc Memory

CC-memory

Claude Code 專案記憶同步系統 - 跨設備、按專案隔離的智能記憶管理

特色

• 🧠 智能記憶萃取 - 使用 Claude 自動分析和摘要 session 內容
• 📁 專案隔離 - 每個專案獨立的記憶空間，互不干擾
• ☁️ 雲端同步 - PostgreSQL 後端，多台電腦自動同步
• 🔍 關鍵字搜尋 - 快速找到相關記憶
• 🎯 記憶分類 - Session 記憶與 Decision 決策分開管理
• 🔌 MCP 標準 - 標準 MCP 協議，與 Claude Code 無縫整合

快速開始

1. 安裝

# Clone 專案
git clone https://github.com/yourusername/CC-memory.git
cd CC-memory

# 安裝依賴
npm install

# 建置
npm run build

2. 設定資料庫

在 Zeabur 或其他服務建立 PostgreSQL 資料庫，然後執行 migration：

# 設定環境變數
export DATABASE_URL=postgresql://user:password@host:5432/cc_memory

# 推送 schema 到資料庫
npx drizzle-kit push

Schema 真相來源：src/db/schema.ts（Drizzle ORM）。 sql/migrations/ 目錄放 drizzle-kit generate 產出的版本化 SQL，禁止手寫 CREATE TABLE 或 SQL function 維護。舊有 sql/schema.sql（Supabase 版） 已於 v0.2 Phase 0 刪除。

3. 配置 Claude Code

# 加入 MCP server
claude mcp add cc-memory \
  -e DATABASE_URL=your-connection-string \
  -- node /path/to/CC-memory/build/index.js

4. 安裝 Skills

cp skills/*.md ~/.claude/skills/

使用方式

儲存記憶

/save-memory

Claude 會分析對話內容，讓你預覽後儲存到資料庫。

載入記憶

/load-memory

載入當前專案的記憶上下文和近期進度。

搜尋記憶

Claude 會自動使用 cc_memory_search 工具搜尋相關記憶。

搜尋關於 "authentication" 的記憶

列出專案記憶

列出這個專案的所有記憶

MCP Tools

架構

Claude Code Session
    ↓
/save-memory skill (Claude 分析摘要)
    ↓
cc_memory_save (MCP tool)
    ↓
PostgreSQL (Drizzle ORM)
    ↓
cc_memory_search / cc_memory_list
    ↓
注入相關 context

配置選項

環境變數：

開發

# 開發模式
npm run dev

# 建置
npm run build

# Drizzle Studio
npx drizzle-kit studio

測試

Integration tests（tests/db/v02-tdd.test.ts）要真 PostgreSQL + pgvector 才能跑，不 silent skip。本機第一次跑測試前：

# 啟動本機 test PG（pgvector/pg16，port 5433）
docker compose -f docker-compose.test.yml up -d

# 推 schema 進 test DB
npx drizzle-kit push --config drizzle.test.config.ts

# 跑測試
npm test

CI 或用現成 test PG 時，設 TEST_DATABASE_URL 跳過本機 docker：

export TEST_DATABASE_URL=postgres://user:pass@host:port/db
npm test

若 test PG 不可用，測試會 fail-loud 並印出上面的指令作為提示。Embedding 相關測試不依賴 GEMINI_API_KEY（用 vi.mock 隔離，不會打真 Gemini API）。

License

MIT License - 自由使用、修改、分享