Skip to main content
Glama
README.md
# Synaptik

Long-term memory and a shared workbench for AI agents (Claude Code, Antigravity and others), running entirely on your own computer.
This repository is a clean starting point: build on it, extend it, or feed it into your own database.

- **Memory:** files and notes become a weighted graph; every item is checked against its source file (`FRESH`, `DRIFTED`, `STALE`, `ORPHANED`).
- **Search:** full-text search with typo tolerance.
- **Teamwork:** a task board with exclusive claims, non-overlapping work areas, messages with replies and a shared HTTP server.
- **Local first:** no cloud, no account. The server listens on `127.0.0.1` only and needs a token.

## Install

**CLI** (any Python 3.14, adds the commands `mmp` and `mmp-server`):

```
pipx install git+https://github.com/Juurpa/synaptik-mcp
mmp agenten einrichten gemini-cli --projekt C:\work\my-project
```

**Claude Code plugin** (needs the CLI above, then registers the MCP server):

```
/plugin marketplace add Juurpa/synaptik-mcp
/plugin install synaptik --marketplace Juurpa/synaptik-mcp
```

Status: pre-release. The [quick guide](docs/Synaptik-Guide-EN.pdf) explains the idea and the five-step setup.

```
python -m venv .venv
.venv\Scriptsctivate
pip install -e .
mmp init C:\work\my-project
mmp agenten einrichten gemini-cli --projekt C:\work\my-project
mmp server start
```

Works with Gemini CLI (`gemini-cli`), Claude Code (`claude-code`) and Antigravity (`antigravity`). `einrichten` writes the MCP entry and the house rules into your project; the server registers each agent itself.

Requires Python 3.14. Code and comments are written in German.

## License and credit

Free and open source (MIT). Use, change and build on Synaptik for free. The one condition is credit: keep the copyright
notice in [LICENSE](LICENSE) and mention Synaptik and its author (Juurpa) wherever you share it or build on it.