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: ~/.mindswap/ 配下での個人用ツール横断メモリのスコープ設定と検索

• reindex: ファイルベースのメモリからローカルのSQLite検索インデックスを再構築

• sync: マシン間で継続性状態を同期

• mcp および mcp-http: AIクライアントに同じコンテキストを公開

グローバルな個人メモリ

MindSwapは現在、2つのローカルメモリスコープをサポートしています。

• <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がワークフローの役に立った場合は、リポジトリにスターを付け、引き継ぎループの改善を続けてください。