gitwtfhub

wtf is synapse?

nrkoka786/synapse — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A local tool that indexes your codebase so Claude and other AI coding assistants can search it privately without sending code to the cloud.

Mindmap

mindmap
  root((synapse))
    What it does
      Watches project folders
      Indexes code locally
      Connects via MCP
    Tech stack
      Python
      MCP protocol
      LanceDB
    Use cases
      Give Claude codebase context
      Search code from terminal
      Auto reindex on save
    Audience
      AI coding assistant users
      Privacy conscious developers
    Setup
      pip install
      Run init command
      Add to Claude config

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let Claude Code automatically pull relevant code snippets from your project without pasting them yourself.

REASON 2

Index a codebase locally so no code leaves your machine.

REASON 3

Search your project's code from the terminal with a single command.

REASON 4

Keep an AI assistant's context up to date automatically as you save files.

What's in the stack?

PythonMCPLanceDBsentence-transformers

How it stacks up

nrkoka786/synapse0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

First run downloads a roughly 400MB local embedding model.

Wtf does this do

Synapse gives the Claude AI assistant knowledge of your own codebase without sending that code to the cloud. Normally when you ask an AI coding assistant for help, you have to explain your project structure, paste in relevant files, and describe your conventions every time. Synapse solves this by watching your project folders, breaking the files into chunks, and turning them into a searchable local index, so Claude can pull up the exact code it needs on its own. You install it with a single pip command, then run a setup command pointing at your project folder. After adding one line to your Claude configuration, Claude connects to Synapse through a protocol called MCP, which lets AI tools call external programs. From then on, whenever you ask Claude a question about your code, it can automatically search the index and pull in the relevant snippets before answering. Everything happens on your own machine by default. Synapse uses a free, local model to turn your code into searchable data, and the only network request is a one time download of that model, around 400 megabytes. There is an optional setting to use OpenAI instead for slightly better search quality, but that sends your code to OpenAI's servers, so the README recommends the local option for private or sensitive projects. A file watcher keeps the index updated automatically as you save changes. Synapse supports many common file types including Python, JavaScript, TypeScript, Go, Rust, Java, and configuration formats like Docker and Makefiles. It works with Claude Code and Cursor today, with Claude Desktop chat support planned for a future release, and it is designed to work with any tool that speaks the MCP protocol rather than being locked to one app. The project is MIT licensed and open to contributions, with a roadmap that includes indexing git history and building out a search interface in the terminal.

Yoink these prompts

Prompt 1
Help me install Synapse and connect it to Claude Code using MCP.
Prompt 2
Explain how Synapse's local embedding model keeps my code private.
Prompt 3
Walk me through configuring watch_paths and ignore_patterns in the config file.
Prompt 4
Show me how to use synapse search to find code from the terminal.

Frequently asked questions

wtf is synapse?

A local tool that indexes your codebase so Claude and other AI coding assistants can search it privately without sending code to the cloud.

What language is synapse written in?

Mainly Python. The stack also includes Python, MCP, LanceDB.

How hard is synapse to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is synapse for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.