Mindpm

mindpm

AI コーディングエージェントのためのプロジェクトメモリーとコントロールプレーン。

mindpm は、プロジェクト用の SQLite ベースの脳を LLM に提供する MCP（Model Context Protocol）サーバーです。タスク、決定事項、アーキテクチャのメモ、セッションのコンテキストを記録するため、新しい会話でも前回の続きから正確に始められます。また、仕様を定めたタスクをコーディングエージェントに引き渡し、並行するエージェント同士の競合を防ぎ、人間が作業を承認して初めて完了として扱います。無人で動作するエージェント向けには、オプションの検証機能が事前にチェックを再実行します。

問題

新しい LLM チャットは、毎回ゼロから始まります。

• 「プロジェクトについて説明します……」
• 「前回、Redis を使うと決めたのは……」
• 「どこまで進めたんだっけ？」

解決策

mindpm はプロジェクトの状態をローカルの SQLite データベースに保存します。LLM は MCP ツールを介してデータを読み書きします。チャット履歴は不要です。メモリー機能も不要です。

You: "What should I work on next?"
LLM: [queries mindpm] "Last session you finished the auth refactor.
      You have 3 high-priority tasks: rate limiting, API docs, and
      the webhook retry bug. Rate limiting is unblocked — start there."

記録する内容

• タスク、仕様、受け入れ条件：引き渡しステータス、優先度、ブロッカーを含みます
• 決定事項：何を決めたのか、その理由、採用しなかった案
• メモとコンテキスト：アーキテクチャ、バグ、アイデア、技術スタック、規約
• セッション：実施したことと次に行うこと、および不在中に変更された内容の概要
• エージェントの試行：タスクに対する各実行と、次の試行で避けるべきこと

クイックスタート

claude mcp add mindpm -e MINDPM_DB_PATH=~/.mindpm/memory.db -- npx -y mindpm

これは Claude Code の設定で、npx が mindpm を取得するため、事前のインストールは不要です。Claude Desktop、Cursor、VS Code、Cline、Windsurf では、別のファイルに同じ JSON 設定を使用します。あとはプロジェクトについて話すだけです。LLM は start_session を呼び出してコンテキストを読み込み、作業を進めながらタスク、決定事項、メモを記録し、end_session を呼び出して次に行うことを保存します。カンバンボードは http://localhost:3131 で利用できます。

仕組み

┌──────────────┐     MCP      ┌─────────┐     SQLite     ┌───────────┐
│ Claude Code, │ ◄──────────► │ mindpm  │ ◄────────────► │ memory.db │
│ Cursor, ...  │    tools     │ server  │   read/write   │           │
└──────────────┘              └─────────┘                └───────────┘

すべてのデータはお使いのマシン上の 1 つの SQLite ファイルに保存されます（デフォルトは ~/.mindpm/memory.db）。mindpm は会話のコンテキストなしで、仕様を定めたタスクをコーディングエージェントに引き渡すこともできます。リース付きのクレームによって並行するエージェント同士の競合を防ぎ、提出された作業はボード上で承認します。無人で動作するエージェント向けには、オプションの検証機能が提出された各コミットのチェックを事前に再実行します。

セキュリティ： mindpm にはユーザーアカウントがなく、お使いのマシン上のプロセスを停止することもできません。シェルを持つエージェントは、あなたになりすましてボードのルートを呼び出したり、データベースを直接編集したりできます。エージェントを無人で実行する前に、セキュリティモデルをお読みください。

ドキュメント

ドキュメント全文：https://umitkavala.github.io/mindpm/

• セットアップ：すべての MCP クライアント、任意の LLM 向けエージェントの指示、ストレージ
• カンバンボード：レーン、作業の承認、ネットワークバインド、WSL
• セッション概要：不在中に変更された内容
• エージェント実行：ライフサイクル、仕様、クレーム、概要
• 上級者向け：無人エージェントと検証
• セキュリティモデル
• MCP ツール
• 開発
• 変更履歴

ライセンス

MIT