Mneo — Data skill for Claude Code

mneo

**Persistent memory for AI agents. No vector DB. No daemon. Just git.**

Why mneo exists and what it refuses to be: [MANIFESTO.md](MANIFESTO.md).

Your coding agent forgot what it figured out in `feat/auth` yesterday. The internet's answer is a vector database, an embedding pipeline, a daemon, and a $20/mo SaaS.

git already does this.

$ git show refs/agent-memory/feat-auth/oauth-flow:note.md
Rejected JWT — session cookies for SSR. Don't re-propose.

Branches are scopes. Refs are storage. `push` and `fetch` are sync. Five verbs, zero infrastructure.

record({ body })                  // save what worked
list({})                          // headlines on this branch
read({ slug })                    // expand a headline
copy({ from, to, slug })          // promote past merge
forget({ slug })                  // outdated

Ships as an [MCP server](https://modelcontextprotocol.io) for Claude Code, or a TypeScript SDK for any agent. ~1500 lines of TypeScript. Zero runtime deps in the SDK. The notes survive uninstall.

---

How it's stored

refs/agent-memory/feat-auth/oauth-flow
refs/agent-memory/main/architecture
refs/agent-memory/main/db-schema

One git ref per note. Slashes in branch names become dashes (`feat/auth` → `feat-auth`). The note's first line becomes the commit subject — that's what `list` returns as headlines.

Inspect like code:

git log  refs/agent-memory/feat-auth/oauth-flow
git show refs/agent-memory/feat-auth/oauth-flow:note.md

Sync like code:

git push  origin 'refs/agent-memory/*:refs/agent-memory/*'
git fetch origin '+refs/agent-memory/*:refs/agent-memory/*'

---

Install

npm install -g mneo mneo-mcp
# or zero-install:
npx -y mneo 

Requires Node `>=18` and `git >= 2.31`.

---

Wire it into Claude Code

One command:

cd your-project
npx -y mneo install

Three pieces land in `.claude/`:

1. A session-start hook that auto-injects recent h