English Français العربية

Mindswap

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package mindswap
Claude Code 
claude mcp add mindswap -- npx -y mindswap@3.3.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mindswap": {
            "command": "npx",
            "args": [
                "-y",
                "mindswap@3.3.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. mindswap
  2. Why it exists
  3. Install
  4. Quick start
  5. What it gives you
  6. Global personal memory
  7. MCP and AI tools
  8. Project state
  9. npm package
  10. Use it

mindswap

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

npm install mindswap --save-dev

Quick start

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx 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.

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 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.

npx mindswap mcp-install
npx mindswap mcp-http

Project state

The main repo data lives in .mindswap/:

.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.

الأسئلة الشائعة

ما هو Mindswap؟

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

كيف أثبّت Mindswap؟

يعمل على جهازك. في Claude Code: claude mcp add mindswap -- npx -y mindswap@3.3.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Mindswap إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Mindswap مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Mindswap؟

ينشره ShipOrBleed. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.