raphasouthall/neurostack

** 로컬 검색 레이어 및 최적화 Markdown 지식 베이스를 이미 가지고 있습니다.**

NeuroStack은 .md] 파일 (Obsidian, Logseq, Notion Exports, Plain Markdown)의 폴더를 전체 텍스트 검색, embeddings 및 wiki-link graph과 하나의 SQLite 데이터베이스로 색인합니다. MCP 클라이언트는 그 때 그것을 검색하고, 그래프를 걸어 기억을 절약 할 수 있습니다. 쿼리는 참고 경로와 순위 증거를 반환, 그리고 당신의 AI는 이유를 수행, 그래서 모델은 당신이 기다립니다. queries NeuroStack 사이에 지식베이스를 정확하게 유지하십시오. AI 세션에서 스테이플, 수확 결정 및 뿌리 원인을 앓고있는 플래그는 기억을 학습으로 병합하고, 입증 된 것들이 노트가 될 수 있습니다. 파일을 변경하지 않고 MCP 쓰기 도구는 클라이언트가 git 역사를 통해 메모를 편집 할 수 있습니다.

Claude, Cursor, Windsurf, Gemini CLI, VS Code, Codex 및 MCP를 지원하는 다른 클라이언트와 함께 작동합니다.

60 초 시작

아래 단계는 각 부분과 다른 AI 클라이언트를 연결하는 방법 설명합니다.

---

당신의 노트, 당신의 통제에서

기본적으로 NeuroStack은 읽기 전용 색인 레이어입니다.

• Indexing, search, summaries 및 graph analysis **가 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.

---