Neurostack banner
raphasouthall raphasouthall

Neurostack

AI community

Description

Your second brain, starting today. CLI + MCP server that helps you build, maintain, and search a knowledge vault that gets better every day. Works with any AI provider. Local-first, zero-prereq install.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

NeuroStack

[![PyPI](https://img.shields.io/pypi/v/neurostack)](https://pypi.org/project/neurostack/) [![npm](https://img.shields.io/npm/v/neurostack)](https://www.npmjs.com/package/neurostack) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE) [![CI](https://github.com/raphasouthall/neurostack/actions/workflows/ci.yml/badge.svg)](https://github.com/raphasouthall/neurostack/actions/workflows/ci.yml) [![MCP](https://img.shields.io/badge/MCP-21%20tools-green)](https://modelcontextprotocol.io)

**Not a note-taking app. A memory layer for the notes you already have.**

Your AI assistant forgets everything when the conversation ends. You ask it about the paper you summarised last week — it has no idea. You ask it to continue the chapter outline you built together — it starts from scratch.

And even when it does find your notes, it might find the wrong version. The thesis argument you reversed, the runbook endpoint you deprecated, the decision you made in April that you overturned in June. It cites these confidently. It has no idea they're wrong.

NeuroStack reads your existing Markdown notes — from Obsidian, Logseq, Notion exports, or any folder of `.md` files — indexes them into a searchable knowledge graph, and connects that graph to your AI. It detects when notes have gone stale before your AI cites them. Your files are never modified.

npm install -g neurostack && neurostack init

Works with Claude, Cursor, Windsurf, Gemini CLI, VS Code, and Codex — anything that supports MCP.


Your notes, untouched

Before anything else: NeuroStack is strictly read-only.

  • Your Markdown files are never modified, moved, or deleted
  • All index data lives in NeuroStack's own separate database
  • To remove it completely: neurostack uninstall — your notes are untouched
  • In local mode: nothing ever leaves your machine
  • In cloud mode: you review and approve