Synaptik
by Juurpa
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.