mex-memory/mex

Team memory for engineers and their AI agents. Lives in your repo. Shared through Git.

What it solves

MEX provides a shared project memory system for engineering teams and their AI coding agents. It solves the problem of fragmented knowledge—where critical architectural decisions, debugging history, and edge cases are trapped in individual engineers' heads or ephemeral agent sessions—by creating a durable, version-controlled home for this context within the Git repository.

How it works

MEX separates canonical knowledge from local retrieval machinery:

  • Canonical Memory: Knowledge is stored as structured Markdown files (Wiki, Specs, Relays, and Inbox proposals) directly in the repository, allowing it to be shared via standard Git commits and pushes.
  • Local Indexes: Each user maintains their own local SQLite-based indexes (Code Graph and Wiki search) that are rebuildable from the canonical files and source code.
  • Code Graph: Uses Tree-sitter grammars to map symbols and relationships in the code (supporting TypeScript, JavaScript, Python, and Rust) to provide precise evidence for AI agents.
  • Grounding: Wiki claims are linked to specific code symbols. If the code changes, MEX flags "drift," signaling that the documentation needs review.
  • Agent Integration: It provides instructions and skills for agents (like Claude Code or Codex) to retrieve context and draft knowledge proposals or handoffs, which humans must then review and approve before they become canonical.

Who it’s for

It is designed for software engineering teams who use AI coding agents and want to ensure that the context learned by one person or agent is preserved and accessible to the rest of the team.

Highlights

  • Git-based sharing: No hosted service or central database is required; memory travels with the code.
  • Project Hub: A local browser-based interface for exploring the knowledge graph, reviewing proposals, and managing handoffs.
  • Relays: A structured way to hand off work between engineers, capturing progress, blockers, and next steps.
  • Code-linked explanations: Direct grounding between prose and implementation to prevent documentation rot.
  • Multi-agent support: Compatible with various AI tools through instruction anchors and specific skills for Claude Code and Codex.

Related

  • Project
  • Project
  • Project
  • Project
  • Project