synaptic-claude-code

Synaptic

An agent-driven indexed memory store with a 3D MRI/CAT-scan-style dashboard. Memories are neurons in anatomical brain regions, shared tags become synapses, and live agent activity fires the regions in real time. Your agent queries the store; Synaptic remembers, organizes, and surfaces what's relevant.

If you want the short read on what Synaptic is and isn't, start with docs/WHAT_SYNAPTIC_IS.md.

By NomadsGalaxy

Introduction

Hello, I'm Nomad, and welcome to Synaptic. For a long time, I've been fascinated by how the brain works, how we think, store memories, conciousness as a whole. As I started to use AI more as a tool in my workflows, I wanted to better understand and visualize how it remembers things, I wanted to see what it would look like if I put my agent's brains in an MRI machine, and watch as the synapses fired, like lightning bolts in clouds.

So, I decided to try my hand at making it, admittedly heavily using Claude to generate it, and after several iterations, I want to publish it. What started as a visualizer ended up growing a full memory backend underneath — so it now does both: an indexed memory store your agent can write to and recall from, and the 3D brain dashboard that shows you what your agent is thinking. I hope you enjoy it as much as I do.

The best experience is to have the visualizer on a secondary monitor while using the plugin method like in Claude CLI, there are some configurations, so have fun with it.

Requirements

The dashboard itself is dependency-free in the browser. Everything else is layered, so you only install the pieces you actually use. Docker is the convenience path, not a hard dependency — every component has a native install option, and the visualization runs end-to-end on the built-in mock engine with nothing more than Python + a browser.

Component	Native requirement	Docker alternative	Required?
SD Core + dashboard (single Go binary; SD Core serves index.html + assets at port 9911)	Go ≥ 1.25 (go build produces a static binary, no runtime deps) and a modern browser (Chrome / Edge / Firefox / Safari, recent versions)	synaptic-core container	Required unless you only want the mock dashboard at :8765 (see below)
Mock-only dashboard (python serve.py, no SD Core)	Python 3.7+ and a modern browser	— (skip Docker entirely)	Optional, lower-fidelity. Brain runs on simulated activity; can't accept real adapter events.
Ollama (region classifier Tier 3 + thought bubbles)	Native install from https://ollama.com, then ollama pull llama3.2:3b	synaptic-ollama-tier1 container	Optional — falls back to keyword-only classification + pre-baked bubble pool
MCP adapter	Node.js ≥ 18 (run npm install in bridge/mcp-adapter/ once)	— (always native)	Only if you wire an MCP-aware client
OTel adapter	Node.js ≥ 18 (bridge/otel-adapter/)	— (always native)	Only if your runtime exports OpenTelemetry traces
Claude Code plugin	Nothing — Claude Code manages it via /plugin install	— (always in-process)	Only if you use Claude Code