zircote

subcog

active
View on GitHub API Docs ADRs
Tech Stack:
RustMCPVector SearchGit Notes

subcog is a high-performance memory system for Claude Code, providing persistent, semantically-searchable memory using git notes as the storage backend.

Features

  • Git-Native Storage --- Memories stored in git notes, versioned and synced with your repository
  • Semantic Search --- Vector-based similarity search for finding relevant context
  • MCP Integration --- Native Model Context Protocol server for Claude Code
  • Fast Indexing --- Rust-powered indexing and retrieval for instant recall
  • Namespace Support --- Organize memories by decisions, patterns, learnings, and more

Architecture

┌─────────────────┐     ┌──────────────────┐
│  Claude Code    │────▶│   MCP Server     │
└─────────────────┘     └──────────────────┘
                               │
                        ┌──────▼──────┐
                        │  Subcog     │
                        │  ┌────────┐ │
                        │  │ Vector │ │
                        │  │ Index  │ │
                        │  └────────┘ │
                        └──────┬──────┘
                               │
                        ┌──────▼──────┐
                        │  Git Notes  │
                        └─────────────┘