Local-first memory for Claude Code: no API key, nothing leaves your machine. Remembers your decisions and the WHY behind them, then hands back just the relevant slice at session start and on every prompt, so you can /clear aggressively without losing context. You curate what matters; bundled semantic + keyword retrieval over a local SQLite store. Self-installs on first run.

version
1.4.11
GitHub stars
305

Install

/plugin install engrim@engrim

Run it inside Claude Code after adding the marketplace with /plugin marketplace add timgordontg/engrim.

Contents

Discovered from source

Agents 1

engrim - Claude Code plugin

Local-first memory for Claude Code, packaged as a one-click plugin - no API key, nothing leaves your machine. It wires a four-hook loop into your sessions so your project's decisions and the why behind them reload automatically, and it self-installs its engine (the engrim CLI) on first run, so there's no separate pip install step.

Clearing your agent's context without engrim feels like closing a doc without hitting save. engrim is the save button: externalize your decisions as you go, then /clear freely and watch them reload intact.

Install

From this repo as a marketplace:

/plugin marketplace add timgordontg/engrim
/plugin install engrim@engrim

On the first session after install, the plugin builds a small private environment and installs the engrim CLI into it (one-time, ~30–90s). After that it's instant. Requires python3 with pip/ensurepip, or uv on your PATH; if neither is present the hooks no-op rather than erroring.

What it wires

EventHookWhat it does
SessionStartbootstrap + engrim hookself-install on first run, then inject the budget-capped boot pack
UserPromptSubmitengrim assistthe minder - inject only the few records relevant to your prompt
Stopengrim log --hooktail the transcript into an append-only log (never enters context)
SessionEndengrim sync --claudefinal seed-gated mirror of file-memory

Configuration

The plugin respects all of engrim's environment variables (ENGRIM_DB, ENGRIM_PROJECT, ENGRIM_EMBED, ENGRIM_NO_GLOBAL, …). Two extras:

VarDefaultPurpose
ENGRIM_PLUGIN_SOURCEengrim==0.7.2What the bootstrap installs (the published PyPI wheel). Point it at a fork, a branch, -e /local/path, or a git ref.

The full project store, the status line, and all commands work exactly as in the main README. This plugin is just the auto-load adapter - the brain is the same local SQLite store.

MIT © 2026 Tim Gordon. Not affiliated with Anthropic.

Sponsors

Details

Marketplace
timgordontg/engrim
Source
plugin
Category
Community
Keywords
memory, context, local-first, no-api-key, privacy, decisions, clear, continuity