# sync82

> sync82 is an open-source MCP server for knowledge and memory. Local SQLite project memory for AI coding agents, kept across sessions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Repository:** https://github.com/oito2/mcp-sync82
- **MCP Registry name:** io.github.oito2/mcp-sync82
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-sync82 -- npx -y https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-sync82": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-sync82": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-sync82": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-sync82": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-sync82": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/oito2/mcp-sync82/releases/download/v1.3.1/sync82.mcpb"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/sync82
