sync82
Local SQLite project memory for AI coding agents, kept across sessions
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 1.3.1
- Listing updated
- 2 days ago
About sync82
sync82 is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Memory lives in a single local SQLite file per vault, shipped as one self-contained binary written in Go with no runtime toolchain. The transport is stdio only, so there is no network service. The agent reads and writes through MCP tools and never touches the database itself.
Each project gets six standard memory files: memory, architecture, stack, decisions, progress and next_steps. Decisions and progress are append-only and dated, the others are overwritten, and custom files are allowed. Subprojects cover monorepos. A .sync82.json file in a workspace lets the agent find the project without being told its name, and load_project_context pulls a project's whole state into one block.
A CLI handles setup and upkeep: sync82 install registers it in Claude Code, Claude Desktop, Antigravity, Codex, OpenCode, Cursor, Zed and Cline; export and import move memory to and from plain Markdown. Releases carry SHA-256 checksums, a Sigstore signature and build provenance, and a .mcpb extension exists for Claude Desktop.
Install
Run in a terminal
claude mcp add mcp-sync82 -- npx -y https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-sync82": {
"command": "npx",
"args": [
"-y",
"https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-sync82": {
"command": "npx",
"args": [
"-y",
"https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-sync82": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-sync82": {
"command": "npx",
"args": [
"-y",
"https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-sync82": {
"command": "npx",
"args": [
"-y",
"https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
]
}
}
}Tools this server provides (19)
Taken from the project documentation; the running server may differ.
- list_projects
- Lists every project and subproject in the vault.
- create_project
- Creates a new project or subproject.
- delete_project
- Permanently deletes a project or subproject after confirmation.
- rename_project
- Renames a project or subproject in place.
- get_vault_config
- Reports the active vault path and config.
- list_files
- Lists every memory file recorded for a project.
- read_memory
- Reads a memory file's content.
- write_memory
- Overwrites a memory file's whole content.
- append_memory
- Appends a dated entry to progress, decisions or a custom append kind.
- delete_memory
- Deletes a custom memory file; the six standard files are protected.
- edit_entry
- Replaces, supersedes or deletes one entry of an append-style file.
- archive_memory
- Archives old dated entries, keeping the last N days active.
- search_memory
- Searches memory files by words, phrase or exact text.
- load_project_context
- Loads a project's memory into one context block.
- check_project_health
- Reports which standard files exist and warns about stale ones.
- init_project_memory
- Guided initialization with optional auto-detection from the codebase.
- update_project_memory
- Saves a session's work in one call.
- export_memory
- Exports a project's memory to Markdown files.
- import_memory
- Imports a project's memory from Markdown files.
What it does
- Six memory files
- Overview, architecture, stack, decisions, progress and next steps for every project.
- One-call context load
- Loads a project's current state and recent history in a single call.
- One-call session save
- Records progress, decisions and next steps together.
- Search and archive
- Searches all memory by words or phrase and archives old dated entries.
- Markdown export and import
- Moves a project's memory to and from plain .md files.
- One-step client setup
- An install command registers the server in eight MCP clients.
- Signed releases
- Checksums, a Sigstore signature and provenance attestations accompany each release.
Good for
- Resume a coding session with the project's goals and decisions already loaded
- Record architectural decisions with dates as work proceeds
- Keep memory across monorepo subprojects
- Back up or review agent memory as Markdown
- Search past progress notes across projects
Pricing
Open source
sync82 FAQ
Where is the data stored?
Locally, in one SQLite file per vault; nothing is sent over a network.
Which clients are supported?
Claude Code, Claude Desktop, Antigravity, Codex, OpenCode, Cursor, Zed and Cline via `sync82 install`.
How many tools does it expose?
Nineteen, plus read-only resources and start_session and end_session prompts.
Do I need a Go toolchain?
Not for a prebuilt binary; Go 1.26 or newer is only needed to build from source.
Is sync82 free?
Yes. sync82 is open source, so you can use and self-host it for free.
How do I add sync82 to Claude Code?
Run this command in your terminal: claude mcp add mcp-sync82 -- npx -y https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb
What are the best alternatives to sync82?
The closest alternatives to sync82 are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to sync82

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools