context-sync - GitLite

KO | EN

gitlite — search

#typescript #android #machine-learning #linux #docker #macos #java #cli #kubernetes #awesome-list #vue #mcp #openai #open-source

context-sync

(★ 186)

Local persistent memory store for LLM applications including continue.dev, cursor, claude desktop, github copilot, codex, antigravity, etc.

File Explorer

Download Latest Version (.zip)

- - context-sync-banner-bidirectional.svg
- - bug_report.md
  - feature_request.md
- cs-logo.png
- auto-configurator.cjs
- install.cjs
- platform-configs.cjs
- register-continue.cjs
- setup.cjs
- - 2026-04-11-1200-audit.md
- CONFIG.md
- DATA.md
- NOTION_INTEGRATION.md
- RELEASE_NOTES.md
- TOOLS.md
- TROUBLESHOOTING.md
- context-layers.ts
- core-tools.ts
- git-context-engine.ts
- git-hook-manager.ts
- git-integration.ts
- git-status-engine.ts
- git-tool-handler.ts
- index.ts
- notion-handlers.ts
- notion-integration.ts
- notion-tool-handler.ts
- path-normalizer.ts
- project-analyzers.ts
- project-cache.ts
- project-detector.ts
- project-metrics.ts
- project-profiler.ts
- project-scanner.ts
- read-file-engine.ts
- recall-engine.ts
- remember-engine.ts
- schema-migration.ts
- schema.ts
- search-engine.ts
- server.ts
- storage.ts
- structure-engine.ts
- tool-responses.ts
- types.ts
- workspace-detector.ts
- workspace-paths.ts
- workspace-tool-handler.ts
.gitignore
.npmignore
AGENTS.md
ARCHITECTURE.md
image.png
LICENSE
package-lock.json
package.json
README.md
RUST-MIGRATION-ASSESSMENT.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Context Sync

Local-first project memory for AI coding tools over MCP.

Context Sync gives an agent a persistent memory layer for a codebase:
- project identity and tech stack
- active work, decisions, constraints, and caveats
- structured file exploration
- git-aware context
- optional read-only Notion lookup

![Context Sync](https://raw.githubusercontent.com/Intina47/context-sync/main/image.png)

## What It Does

Context Sync is built for session continuity. Instead of relying on a model to remember earlier conversations, it stores the project context that matters and makes it retrievable through a small MCP tool surface.

The current core tools are:
- `set_project`
- `remember`
- `recall`
- `read_file`
- `search`
- `structure`
- `git`
- `notion`

## Install

Install globally:

```bash
npm install -g @context-sync/server
```

Auto-configuration runs during global install. After install, restart your AI tool.

If you install locally instead of globally, auto-config does not run. Use the manual config guide in [docs/CONFIG.md](docs/CONFIG.md).

## Verify

Check that `context-sync` appears in your MCP tool list:
- Claude Desktop: open the tools list
- Cursor: open the tools list
- VS Code / Copilot Chat Agent mode: check tools
- Continue.dev: open the Continue panel
- Codex CLI: `codex mcp list`
- Claude Code: `claude mcp list`

If auto-config fails, use [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) and [docs/CONFIG.md](docs/CONFIG.md).

## Optional Notion Setup

Run the setup wizard if you want Notion integration:

```bash
context-sync-setup
```

or:

```bash
npx context-sync-setup
```

Notion support is intentionally read-only at the tool surface:
- `notion({ action: "search", query: "..." })`
- `notion({ action: "read", pageId: "..." })`

## First-Time Workflow

Start every new session by setting the project first:

```text
1. set_project({ path: "/absolute/path/to/project" })
2. recall()
3. structure({ depth: 2 })
4. read_file({ path: "src/index.ts" })
5. remember({ type: "decision", content: "Use SQLite for local storage" })
```

Recommended pattern:
- `set_project` once per project/session start
- `recall` to recover context
- `structure` and `search` to explore
- `read_file` for focused inspection
- `remember` when something should survive the current session

## Git Integration

When you run `set_project` inside a git repository, Context Sync can install hooks for automatic context capture.

Installed hooks:
- `post-commit`
- `pre-push`
- `post-merge`
- `post-checkout`

Hooks are marked with `Context Sync Auto-Hook`, and existing hooks are backed up first.

The `git` tool supports:
- `status`
- `context`
- `hotspots`
- `coupling`
- `blame`
- `analysis`

## Data And Config

Default locations:
- Database: `~/.context-sync/data.db`
- Config: `~/.context-sync/config.json`
- Install status: `~/.context-sync/install-status.json`

Custom database options:
- CLI: `context-sync --db-path /absolute/path/to/db`
- Env var: `CONTEXT_SYNC_DB_PATH`

See [docs/DATA.md](docs/DATA.md) for storage details.

## Supported Platforms

- Claude Desktop
- Cursor
- VS Code + GitHub Copilot
- Continue.dev
- Zed
- Windsurf
- Codeium
- TabNine
- Codex CLI
- Claude Code
- Antigravity

## Docs

- [docs/TOOLS.md](docs/TOOLS.md)
- [docs/CONFIG.md](docs/CONFIG.md)
- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
- [docs/DATA.md](docs/DATA.md)
- [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md)