contextify

# Contextify

<p align="center">
  <img width="456" height="456" alt="Contextify Logo" src="https://github.com/user-attachments/assets/bb64c170-d4e0-4f09-9f60-467bd9f043f8" />
</p>

<p align="center">
  <a href="https://github.com/atakanatali/contextify/actions/workflows/release.yml">
    <img src="https://github.com/atakanatali/contextify/actions/workflows/release.yml/badge.svg" alt="Publish" />
  </a>
  <a href="https://github.com/atakanatali/contextify/releases">
    <img src="https://img.shields.io/github/v/release/atakanatali/contextify?include_prereleases" alt="Release" />
  </a>
  <a href="https://github.com/atakanatali/contextify/pkgs/container/contextify">
    <img src="https://img.shields.io/badge/ghcr.io-contextify-blue?logo=docker" alt="Docker Image" />
  </a>
  <a href="https://github.com/atakanatali/contextify/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/atakanatali/contextify" alt="License" />
  </a>
</p>

Unified memory system for AI agents. Provides shared short-term and long-term memory across Claude Code, Codex, Cursor, Windsurf, Cursor, and any other AI tool.

**Key features:**
- **Smart Store** — automatic deduplication with similarity-based merge (>= 0.92 auto-merge, 0.75-0.92 suggest)
- **Project ID Normalization** — VCS-agnostic canonical names (worktrees, different machines, renames all resolve to the same identity)
- **Semantic + Keyword Search** — hybrid search with pgvector HNSW + full-text (70/30 weighting)
- **Memory Consolidation** — merge strategies (latest_wins, append, smart_merge), background dedup scanner, Web UI review
- **Multi-Agent** — MCP for Claude Code/Codex/Cursor/Windsurf, REST API for Cursor and others

<img width="3004" height="1437" alt="image" src="https://github.com/user-attachments/assets/939ef56d-9fcc-4c8b-a85b-29f9de4256e5" />

## Core Architecture

```mermaid
graph TB
    subgraph Agents["AI Agents"]
        CC[Claude Code]
        CX[Codex]
        CU[Cursor]
        WS[Windsurf]