# SynapsesOS

> The nervous system for AI agents.

SynapsesOS is the nervous system for AI agents. It gives agents a structured world model, persistent memory, and coordination — so they understand what they're working in, remember what they've learned, and act precisely instead of guessing.

SynapsesOS is not an AI model or LLM. It sits between your agent (Claude Code, Cursor, Windsurf, Zed, etc.) and the domain it operates in, via the Model Context Protocol (MCP).

## Core Values

**Speed** — Context delivered in milliseconds. BFS ego-graph slices. Local graph, no cloud round-trip.

**Accuracy** — Typed graph edges (CALLS, IMPLEMENTS, IMPORTS, DATA_FLOW), not fuzzy embeddings. Exact impact analysis, exact call chains, zero hallucinated relationships.

**Sovereignty** — Your data, your storage. Always. SynapsesOS is the engine — you choose where it runs and where data lives. We never store your data.

## Data Sovereignty Modes

- **Solo local**: SQLite at ~/.cache/synapses/ on your machine
- **Solo cloud**: Your own VPS or cloud VM — your infrastructure
- **Team**: Shared storage on GitHub, S3, or any storage your team controls
- **Enterprise**: Central SynapsesOS instance, data on company infrastructure

In all modes: Synapses never holds your data, never sees it, has no cloud storage.

## What it does today (Code domain)

- Parses codebases into a typed relationship graph — functions, methods, structs, interfaces with explicit CALLS, IMPLEMENTS, IMPORTS, DATA_FLOW edges
- Serves BFS ego-graph context slices to AI agents via 45+ MCP tools
- Maintains persistent cross-session memory — agents remember decisions, failures, lessons
- Enables multi-agent coordination — work claims, conflict detection, agent message bus
- Enforces architectural rules — no-call constraints, violation reporting before code is written
- Provides impact analysis — "what breaks if I change this function?" answered precisely
- 49+ programming languages: Go, TypeScript, Python, Java, Rust, C, C++, C#, Swift, Ruby, PHP, Kotlin, Scala, Lua, Elixir, Haskell, OCaml, Dart, R, Julia, Perl, Protobuf, Groovy, and more

## What's coming (Domain expansion)

- Infrastructure: Terraform, Kubernetes YAML, Helm
- APIs: OpenAPI, GraphQL schema
- Documentation: Markdown, Confluence, Notion
- Data pipelines: dbt, Airflow DAGs, SQL

Same graph engine, same MCP tools, same memory and coordination. Any domain an agent operates in.

## Key properties

- **MCP-native**: Works with Claude Code, Cursor, Windsurf, Zed, Gemini, and any MCP-compatible agent
- **Single binary**: One binary, no dependencies, zero-config setup
- **Local-first**: Full functionality with no internet connection
- **Fail-silent**: Sidecars crash? Core graph queries still work
- **Open source**: MIT License, free forever

## Install

### Desktop App (recommended)
Download from: https://github.com/SynapsesOS/synapses-app/releases/latest

### CLI / Homebrew
```
brew install SynapsesOS/tap/synapses
synapses init
```

### Go install
```
go install github.com/SynapsesOS/synapses@latest
```

## MCP Configuration

```json
{
  "synapses": {
    "command": "synapses",
    "args": ["serve"]
  }
}
```

## Available MCP tools (45+)

session_init, end_session, get_context, find_entity, search, get_file_context, get_call_chain, get_impact, get_peer_activity, claim_work, get_conflicts, release_claims, create_plan, get_plans, get_pending_tasks, update_task, link_task_nodes, save_session_state, get_session_state, remember, recall, annotate_node, validate_plan, verify_implementation, check_plan_safety, get_violations, upsert_rule, get_rule_candidates, send_message, get_messages, get_agents, get_events, get_working_state, prepare_context, plan_context, get_gaps, upsert_gap, get_adrs, upsert_adr, get_project_identity, get_repo_map, discover_tools, list_skills, execute_skill, lookup_docs, explain_codebase, web_search, web_fetch, web_annotate, report_usage

## Links

- Website: https://synapsesos.com
- Desktop App: https://github.com/SynapsesOS/synapses-app
- Core (source): https://github.com/SynapsesOS/synapses
- Releases: https://github.com/SynapsesOS/synapses-app/releases
- Sitemap: https://synapsesos.com/sitemap-index.xml