Skip to main content
Open source · MCP-native

Persistent memory for your coding agents

Mindr watches your commits and learns your codebase — conventions, decisions, and debt — then feeds that context to any AI agent so it stops re-reading the world at the start of every session.

npm i -g mindragent · Node 22+Works with SQLite or Remembr
zsh — your-project
# install & initialize — once
$ npm i -g mindragent
$ mindr init
  ✓ Backend: sqlite
  ✓ Hook installed · convention scan done

# every commit is captured automatically
$ git commit -m "migrate to tRPC"
  → decision stored (confidence 0.8)

# your agent now starts oriented
$ mindr generate agents-md
  ✓ AGENTS.md — commands, conventions, decisions

What it captures

Memory that maintains itself

No prompting, no manual note-taking. Mindr derives durable context from the work you already do — commits — and keeps it current.

Learns your conventions

Tree-sitter parses every commit to detect naming, file, and test-layout patterns per language — with confidence scores.

Captures decisions

Meaningful commits (switch, migrate, refactor, dependency changes) become durable decision memories agents can recall.

Tracks technical debt

TODO / FIXME / HACK markers are captured, aged, and severity-scored — then resolved automatically when you remove them.

Remembers bug patterns

Structural fixes are recorded so agents can be warned before they write the same class of bug again.

MCP for any agent

One stdio MCP server exposes get_context, remember, query, and more to Claude Code, Cursor, Codex, Aider, and others.

Generates AGENTS.md

Auto-detected commands, stack, conventions, decisions, and warnings — written to AGENTS.md / CLAUDE.md, kept fresh.

How it works

Three steps, then it runs itself

1

You commit

A post-commit git hook fires on every commit — nothing to run manually.

git commit -m "migrate auth to JWT + Redis"
2

Mindr learns

It extracts conventions, decisions, debt, and bug patterns, and stores them in SQLite or Remembr.

mindr status # memories per type
3

Agents stay oriented

Your agent calls get_context (or reads AGENTS.md) and starts every session already knowing the codebase.

mindr generate agents-md

At session start

Exactly what your agent receives

A compact, token-budgeted brief — ordered by priority and trimmed to fit. One call to get_context and the agent knows your stack, commands, conventions, and recent decisions.

mindr:get_context
=== MINDR CONTEXT ===

[RECENT DECISIONS]
  2026-05-01 — migrate auth to JWT + Redis [keyword]
  2026-04-15 — switch internal APIs to tRPC [keyword]

[COMMANDS]
  Install: pnpm install
  Build:   pnpm build
  Test:    pnpm test
  Lint:    pnpm lint

[CONVENTIONS]
  typescript: functionNames=camelCase(97%), classNames=PascalCase(100%)

[STACK OVERVIEW]
  Languages: TypeScript
  Stack: Express, PostgreSQL, tRPC, Redis
  Hot modules: api (12), auth (7)

=== END CONTEXT ===

Bring your own agent

One memory, every tool

Mindr speaks the Model Context Protocol, so the same memory works across the agents your team already uses.

Give your agents a memory

Install, commit, and let Mindr do the rest. Local SQLite by default — zero config.