Mindswap

io.github.ShipOrBleed由 GitHub 帳號 ShipOrBleed 發布v3.3.0更新於 Oct 24, 2026

Local-first AI context and memory server for cross-tool coding continuity.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

本地優先的記憶伺服器，保存編碼任務脈絡、決策與阻礙，讓 AI 工具不必重複說明就能接續工作。

可以做什麼
  • 儲存與恢復專案脈絡：記錄目前任務、git 狀態與決策，並以清楚的簡報開始新工作階段
  • 附引用檢索專案記憶，並針對過去的決策提問
  • 管理阻礙、假設、問題與解決方案，可存於儲存庫或全域個人記憶
  • 初始化儲存庫、匯入既有 AI 脈絡、檢查設定健康與過期脈絡，並重建本機 SQLite 搜尋索引
  • 在多台機器間共享延續狀態，並透過 MCP 把同一份脈絡提供給 AI 用戶端
適用情境
適合在多个 AI 編碼工具或工作階段之間切換、經常遺失脈絡的情況，或希望把決策與交接說明保存在儲存庫本機並跨專案重用。
執行需求
以本機程序方式執行，從 npm 套件 mindswap 安裝（需要 Node.js）。未宣告帳號、API 金鑰或環境變數。記憶以檔案形式存放在儲存庫的 .mindswap 目錄，全域範圍則存放在使用者家目錄下。
安裝前請注意
會將脈絡檔案寫入儲存庫及個人主目錄儲存區，sync 指令還會在多台機器間共享延續狀態，同步前請確認所記錄的內容。儲存的脈絡可能包含任務細節、決策與 git 狀態。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mindswap，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mindswap

[npm version] [License: MIT]

Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.

Why it exists

AI sessions reset too often. mindswap saves the current task, decisions, blockers, and handoff context so the next tool can pick up cleanly.

Install

bash
npm install mindswap --save-dev

Quick start

bash
npx mindswap initnpx mindswapnpx mindswap doctornpx mindswap resumenpx mindswap ask "Why did we choose JWT?"

What it gives you

  • init to set up a repo and import existing AI context
  • save to capture the current task, git state, and decisions
  • doctor to check setup health and stale context
  • resume to start with a clean briefing
  • ask to search project memory with citations
  • memory to manage blockers, assumptions, questions, and resolutions
  • --global memory and ask scope for personal cross-tool memory under ~/.mindswap/
  • reindex to rebuild the local SQLite search index from your file-based memory
  • sync to share continuity state across machines
  • mcp and mcp-http to expose the same context to AI clients

Global personal memory

MindSwap now supports two local memory scopes:

  • repo memory in <repo>/.mindswap/
  • personal memory in ~/.mindswap/

Use global memory when a preference or learning should follow you across projects and tools.

bash
npx mindswap log "Prefer concise explanations" --type assumption --globalnpx mindswap memory list --scope allnpx mindswap ask "What explanation style should we use?" --scope allnpx mindswap reindex --scope all

MCP and AI tools

mindswap generates context for tools like Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI, and AGENTS.md-based workflows.

bash
npx mindswap mcp-installnpx mindswap mcp-http

Project state

The main repo data lives in .mindswap/:

text
.mindswap/├── HANDOFF.md├── state.json├── decisions.log├── memory.json├── config.json├── branches/└── history/

npm package

Use it

If mindswap helps your workflow, star the repo and keep improving the handoff loop.

來源：README.md，提交 83bedef

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v3.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分