gitmem
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ο»Ώ
β‘ The Problem
AI coding agents (Claude Code, Cursor, Windsurf, Antigravity) lose their memory between sessions. Every time you open a new conversation, change branches, or have a teammate pull the code:
Architectural decisions are forgotten.
Past bugs and lessons are repeated.
Complex multi-step task graphs get lost.
Beads introduced versioned agent memory, but requires a heavy Go binary and an external Dolt SQL database daemon running on your machine.
gitmem gives your agents persistent, dependency-aware memory stored as plain JSON and Markdown committed directly into your repository.
Related MCP server: ITHZ MCP
π₯ Beads vs. gitmem
Feature | Beads | π§ gitmem |
Runtime | Go binary | Node.js / TypeScript Native |
Storage Engine | Dolt SQL Database Daemon | Plain Git (JSON + Readable Markdown) |
Installation | Heavy custom install / Dolt setup |
|
Install Size | ~150 MB+ | < 3 MB |
PR & Code Review | Hidden in Dolt binary storage | Clean, reviewable |
MCP Standard | Custom protocol wrappers | Native |
Human Readable | Requires SQL queries | Auto-syncs |
π 30-Second Quickstart
In your repository root:
npx gitmem initThat's it! gitmem will scaffold .gitmem/ and automatically configure your Cursor (.cursor/mcp.json) or Claude Desktop environment.
Attach to Claude Code
claude mcp add gitmem npx -y gitmem mcpAttach to Cursor / Windsurf
Add this to your MCP configuration (.cursor/mcp.json or settings):
{
"mcpServers": {
"gitmem": {
"command": "npx",
"args": ["-y", "gitmem", "mcp"]
}
}
}π οΈ MCP Tools for Agents
When attached to an agent, gitmem exposes these standard MCP tools:
gitmem_context: Dumps instant project briefing (tech stack, conventions, critical gotchas, and top unblocked tasks).gitmem_remember: Records an architectural decision, lesson, or preference.gitmem_recall: Fuzzy-searches past decisions and gotchas to avoid repeating mistakes.gitmem_task_create: Adds a task with dependency tracking (blockedBy: ["task-1"]).gitmem_task_claim: Claims a task for the active agent session.gitmem_task_complete: Marks task complete and automatically unblocks downstream tasks.gitmem_task_list: Queries tasks (e.g.--readyfor unblocked tasks only).
π» CLI Usage
You can also use gitmem directly from your terminal:
Remember a Decision
npx gitmem remember "Use Argon2 for password hashing" \
--category decision \
--message "Argon2id is memory-hard and prevents ASIC/GPU attacks." \
--tags auth securityRecall Memories
npx gitmem recall "password"Manage Task Dependency Graph
# 1. Create root task
npx gitmem tasks create "Design database schema" --priority high
# 2. Create dependent task (blocked by task-1)
npx gitmem tasks create "Build authentication API" --blocked-by task-1
# 3. View task board
npx gitmem tasks list
# 4. Complete root task (unblocks task-2)
npx gitmem tasks done task-1 --outcome "Prisma schema created"Instant Agent Bootstrap
# Dump formatted project context to terminal or clipboard
npx gitmem contextπ Repository Layout
Everything is stored inside your repository under .gitmem/:
your-repo/
βββ .gitmem/
β βββ config.json # gitmem settings (auto-commit, prefix)
β βββ memories.json # Structured decisions, lessons, context
β βββ MEMORIES.md # Auto-generated human-readable memory log
β βββ tasks.json # Dependency graph (blockedBy, claimedBy)
β βββ TASKS.md # Auto-generated markdown task board
β βββ context.json # Stack, conventions & non-negotiablesBecause it lives in git:
Branch-aware: Branches keep their own context or inherit from main.
Team-shared: Every
git pullupdates your local agent's memory.Reviewable: You can see every AI agent decision in standard GitHub pull requests!
π License
MIT Β© KuraPiee β Built with β€οΈ by the Docwyrm Team.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Shared project memory for coding agents: decisions, lessons, guardrails and tasks per repository.
One memory for every AI you work with: your rules, notes and decisions in your own Git repo.
Shared project memory for AI coding agents: decisions, lessons, risks and tasks in one graph.
Project memory for coding agents: requirements, decisions, code graph and delivery telemetry.
Related MCP Servers
- AlicenseAqualityAmaintenanceLocal-first memory layer for AI coding agents β captures issues, attempts, fixes, and decisions, and warns at git commit before you repeat a mistake.17723 PyPI879MIT
- FlicenseNot gradedqualityCmaintenanceLocal-first deterministic project memory for AI coding agents, with context packs, decisions, gates, risks, scoped claims and explicit checkpoints in project-owned files.-
- AlicenseAqualityDmaintenanceLocal-first project memory for AI coding agents. Records failed attempts, fragile files, and decisions per repo, and warns the agent via hooks before it repeats a recorded mistake.669 npmMIT
- AlicenseAqualityBmaintenanceA lightweight, Git-backed permanent memory for AI agents.323 PyPI60MIT