Skip to content
MCP server

sync82

Local SQLite project memory for AI coding agents, kept across sessions

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools