{
  "markdown": "# mindswap\n\n[![npm version](https://img.shields.io/npm/v/mindswap.svg)](https://www.npmjs.com/package/mindswap)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nKeep project context and personal AI memory local so tools can continue work without re-explaining the same context.\n\n## Why it exists\n\nAI sessions reset too often. mindswap saves the current task, decisions, blockers, and handoff context so the next tool can pick up cleanly.\n\n## Install\n\n```bash\nnpm install mindswap --save-dev\n```\n\n## Quick start\n\n```bash\nnpx mindswap init\nnpx mindswap\nnpx mindswap doctor\nnpx mindswap resume\nnpx mindswap ask \"Why did we choose JWT?\"\n```\n\n## What it gives you\n\n- `init` to set up a repo and import existing AI context\n- `save` to capture the current task, git state, and decisions\n- `doctor` to check setup health and stale context\n- `resume` to start with a clean briefing\n- `ask` to search project memory with citations\n- `memory` to manage blockers, assumptions, questions, and resolutions\n- `--global` memory and ask scope for personal cross-tool memory under `~/.mindswap/`\n- `reindex` to rebuild the local SQLite search index from your file-based memory\n- `sync` to share continuity state across machines\n- `mcp` and `mcp-http` to expose the same context to AI clients\n\n## Global personal memory\n\nMindSwap now supports two local memory scopes:\n\n- repo memory in `<repo>/.mindswap/`\n- personal memory in `~/.mindswap/`\n\nUse global memory when a preference or learning should follow you across projects and tools.\n\n```bash\nnpx mindswap log \"Prefer concise explanations\" --type assumption --global\nnpx mindswap memory list --scope all\nnpx mindswap ask \"What explanation style should we use?\" --scope all\nnpx mindswap reindex --scope all\n```\n\n## MCP and AI tools\n\nmindswap generates context for tools like Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI, and AGENTS.md-based workflows.\n\n```bash\nnpx mindswap mcp-install\nnpx mindswap mcp-http\n```\n\n## Project state\n\nThe main repo data lives in `.mindswap/`:\n\n```text\n.mindswap/\n├── HANDOFF.md\n├── state.json\n├── decisions.log\n├── memory.json\n├── config.json\n├── branches/\n└── history/\n```\n\n## npm package\n\n- npm: https://www.npmjs.com/package/mindswap\n- GitHub: https://github.com/ShipOrBleed/mindswap\n\n## Use it\n\nIf mindswap helps your workflow, star the repo and keep improving the handoff loop.\n",
  "bytes": 2442,
  "sha": "e15ef8cd4bd8e53421cc2c11b5bef372f8596f4a6cefef57100a75864835f46d",
  "repo_slug": "shiporbleed/mindswap",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shiporbleed_mindswap_c13d794b/readme"
}