raphasouthall/neurostack

すでに持っているMarkdownの知識ベースのためのローカル検索レイヤーとオプティマイザ。

NeuroStack は、 [.md]] ファイルのフォルダーをインデックス化します。 (Obsidian, Logseq, Notion エクスポート, プレーン マークダウン) を 1 つの SQLite データベースにフルテキスト検索, 埋め込みと wiki リンク グラフ. MCP クライアントは、検索して、グラフを移動してメモリを保存することができます。 クエリはノートパスでランクされたエビデンスを返し、AIは推論を行い、待ち時間にモデルが実行されません。 クエリ間で NeuroStack 知識ベースを正確保ちます. それは、あなたのAIセッションから失礼、決定を収穫し、根本的な原因を収穫し、記憶を学習にマージし、実証済みのものをノートになるようにキューをフラグします。 ファイルを決して変更せず、オプションの MCP 書き込みツールは、クライアントが git 履歴を使ってメモを編集できるようにします。

Claude、Cursor、Windsurf、Gemini CLI、VSコード、Codex、MCPをサポートする他のクライアントと連携します。

60秒の開始

以下の手順では、各パートと他のAIクライアントを接続する方法について説明します。

お問い合わせ

あなたのメモ、あなたのコントロール

デフォルトでは、NeuroStackは読み取り専用のインデックスレイヤーです。

• 索引付け、検索、要約、グラフ解析Markdownファイルを変更しない

A local retrieval layer and optimizer for the Markdown knowledge base you already have.

NeuroStack indexes a folder of .md files (Obsidian, Logseq, Notion exports, plain Markdown) into one SQLite database with full-text search, embeddings and a wiki-link graph. Any MCP client can then search it, walk the graph and save memories. A query returns ranked evidence with note paths, and your AI does the reasoning, so no model runs while you wait. Between queries NeuroStack keeps the knowledge base accurate. It flags notes that have gone stale, harvests decisions and root causes from your AI sessions, merges recurring memories into learnings, and queues the proven ones to become notes. Indexing never changes your files, and optional MCP write tools let a client edit notes through your git history.

Works with Claude, Cursor, Windsurf, Gemini CLI, VS Code, Codex and any other client that supports MCP.

60-second start

npm install -g neurostack          # install
neurostack init                    # pick your notes folder, press Enter for the rest
/save                              # in omp or Claude Code, keep what this session learned
neurostack doctor                  # check that everything works

The steps below explain each part and how to connect other AI clients.

---

Your notes, in your control

By default, NeuroStack is a read-only indexing layer:

• Indexing, search, summaries, and graph analysis never modify your Markdown files
• All index data lives in NeuroStack’s own separate database
• To remove it completely, run neurostack uninstall. Your notes stay untouched.
• Nothing ever leaves your machine, unless you configure a third-party LLM provider for summaries and embeddings

If your vault is a git repo, four opt-in MCP write tools let an AI client author and edit notes for you: vault_write_file, vault_delete_file, plus vault_read_file / vault_list_files. Every write commits and pushes to your git remote with a descriptive message, so every change is visible in git log, revertable with git revert, and serialised under a per-vault lock. Writes hard-reject invalid frontmatter, paths outside the vault, and hidden directories (.git, .obsidian, …). Because the tools are exposed to any client talking to neurostack serve, gate them at the transport (auth, tunnel, LAN only) if you put the MCP endpoint on the public internet.

---