mindswap

保持项目上下文和个人 AI 记忆在本地，以便工具可以在无需重新解释相同上下文的情况下继续工作。

为什么存在

AI 会话重置过于频繁。mindswap 保存当前任务、决策、阻碍和交接上下文，以便下一个工具可以顺利接手。

安装

npm install mindswap --save-dev

快速开始

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"

它能为你提供什么

• init 用于设置仓库并导入现有的 AI 上下文

• save 用于捕获当前任务、git 状态和决策

• doctor 用于检查设置健康状况和过期的上下文

• resume 用于以清晰的简报开始工作

• ask 用于通过引用搜索项目记忆

• memory 用于管理阻碍、假设、问题和解决方案

• --global 记忆和 ask 作用域，用于 ~/.mindswap/ 下的个人跨工具记忆

• reindex 用于从基于文件的记忆中重建本地 SQLite 搜索索引

• sync 用于在不同机器间共享连续性状态

• mcp 和 mcp-http 用于向 AI 客户端公开相同的上下文

全局个人记忆

MindSwap 现在支持两种本地记忆作用域：

• <repo>/.mindswap/ 中的仓库记忆

• ~/.mindswap/ 中的个人记忆

当偏好设置或学习内容需要在不同项目和工具间跟随你时，请使用全局记忆。

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

MCP 和 AI 工具

mindswap 为 Claude Code、Cursor、Copilot、Codex、Windsurf、Cline、Roo、Aider、Amp、Gemini CLI 以及基于 AGENTS.md 的工作流等工具生成上下文。

npx mindswap mcp-install
npx mindswap mcp-http

项目状态

主要的仓库数据位于 .mindswap/ 中：

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

npm 包

• npm: https://www.npmjs.com/package/mindswap

• GitHub: https://github.com/ShipOrBleed/mindswap

使用它

如果 mindswap 对你的工作流有帮助，请给仓库加星，并继续改进交接循环。