# Mindswap

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/ShipOrBleed/mindswap.git  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mindswap

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mindswap": {
    "command": "npx",
    "args": ["-y","mindswap"]
  }
}
```

## Documentation & README

# mindswap

[![npm version](https://img.shields.io/npm/v/mindswap.svg)](https://www.npmjs.com/package/mindswap)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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 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.

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

```bash
npx mindswap mcp-install
npx 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

- npm: https://www.npmjs.com/package/mindswap
- GitHub: https://github.com/ShipOrBleed/mindswap

## Use it

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