raphasouthall/neurostack

Локальный слой поиска и оптимизатор базы знаний Markdown, которую вы уже имеете.

NeuroStack индексирует папку файлов .md (Obsidian, Logseq, Notion export, plain Markdown) в одну базу данных SQLite с полнотекстовым поиском, встраиванием и графиком вики-ссылок. Любой клиент MCP может найти его, пройти по графику и сохранить воспоминания. Запрос возвращает ранжированные доказательства с заметками, и ваш ИИ делает рассуждения, поэтому ни одна модель не работает, пока вы ждете. Между запросами NeuroStack сохраняет базу знаний точной. Он помечает застойные заметки, собирает решения и первопричины из ваших сеансов ИИ, объединяет повторяющиеся воспоминания в обучение и ставит в очередь проверенные, чтобы стать заметками. Индексирование никогда не изменяет ваши файлы, а дополнительные инструменты записи MCP позволяют клиенту редактировать заметки в вашей истории git.

Работает с Claude, Cursor, Windsurf, Gemini CLI, VS Code, Codex и любым другим клиентом, поддерживающим MCP.

60-секундный старт

Следующие шаги объясняют каждую часть и как подключить других клиентов ИИ.

##Ваши записи под вашим контролем

По умолчанию 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.

---