Engrm

Official

by dr12hes · TypeScript

Shared memory across devices, sessions, and agents for OpenClaw, Claude Code, and Codex.

Shared persistent memory across devices, sessions, and agents for multiple AI platforms.

Topics

ai-memoryclaude-codecodexcoding-agentcross-devicemcpopenclawpersistent-memorysentinelsqlite-vectypescriptdelivery-review

README.md12 KBView on GitHub

Engrm

The only AI memory that syncs across devices and agents.

Cross-device persistent memory for OpenClaw, Claude Code, Codex, and any MCP-compatible agent. Start free with 2 devices.

Get Started • Documentation • Blog

Why Engrm?

Cross-device sync — Fix a bug on your laptop, continue on your desktop. No other memory tool does this.
Cross-agent compatible — Works with OpenClaw, Claude Code, Codex, Cursor, Windsurf, Cline, Zed
Free tier — 2 devices, 5,000 observations, full sync. £0 forever.
Offline-first — Local SQLite + sqlite-vec. <50ms search. Works on a plane.
Delivery Review — Compare what was promised vs what shipped
Sentinel — Real-time code audit before changes land
Team memory — Share insights across your whole team (Team plan)

vs Other Memory Tools

Feature	Engrm Free	Supermemory Pro	mem0
Cost	£0	$20/mo	~$2/mo + usage
Cross-device	✅ 2 devices	❌ Single device	❌ Single device
OpenClaw plugin	✅ Native	✅ (Pro required)	✅ (usage costs)
Works with Claude/Codex	✅	❌	❌
Delivery Review	✅	❌	❌
Sentinel	✅ (Vibe+)	❌	❌

Read the full comparison →

Installation

For OpenClaw Users

bash

# 1. Install the plugin
openclaw plugins install engrm-openclaw-plugin

# 2. Restart OpenClaw
# Quit and reopen, or restart gateway

# 3. Connect Engrm in chat
/engrm connect

# 4. Verify
/engrm status

What works:

✅ Session startup memory injection
✅ Automatic session capture
✅ Cross-device sync (unique to Engrm)
✅ /engrm slash commands
✅ Sentinel advisory mode (Vibe+ plans)

Blog: Engrm Now Supports OpenClaw →

For Claude Code / Codex

bash

npx engrm init

This auto-configures MCP servers and hooks in ~/.claude.json and ~/.codex/config.toml.

Alternative methods:

bash

# From a provisioning token (shown on engrm.dev after signup)
npx engrm init --token=cmt_your_token

# Self-hosted Candengo Vector
npx engrm init --url=https://vector.internal.company.com

# Manual setup (air-gapped environments)
npx engrm init --manual

For npm users, Engrm runs on Node.js 18+ and does not require Bun to be installed.

How It Works

Background Operation

Engrm works automatically:

Session start — injects relevant project memory into context
While you work — captures observations from tool use where the agent exposes that hook surface
Session end — generates a session digest, syncs to cloud, and turns recent work into a denser project brief

code

━━━ Engrm Session Summary ━━━

📋 Request: Fix the OAuth redirect validation
🔍 Investigated: redirect_uri handling in auth.py
💡 Learned: scheme + host + port must all match registered URIs
✅ Completed: Stricter redirect_uri validation (auth.py)

🟢 Risk: Low (0.12)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Check Status

bash

npx engrm status

code

Engrm Status

  User:        david
  Email:       david@example.com
  Device:      macbook-a1b2c3d4
  Plan:        Pro (£9.99/mo)
  Candengo:    https://www.candengo.com
  MCP server:  registered
  Codex MCP:   registered
  Hooks:       registered (6 hooks)
  Codex hooks: registered (2 hooks)

  Observations:    1,247 active
  By type:         change: 412, discovery: 289, bugfix: 187, ...
  Sentinel:        enabled (advisory, 142/200 today)
  Sync:            push 2m ago, pull 5m ago
  Security:        3 findings (1 high, 2 medium)

Architecture

Claude Code session:

code

 │
 ├─ SessionStart hook ──→ inject relevant memory into context
 │
 ├─ PreToolUse hook ────→ Sentinel audits Edit/Write (optional)
 │
 ├─ PostToolUse hook ───→ extract observations from tool results
 │
 ├─ PreCompact hook ────→ re-inject memory before context compression
 │
 ├─ ElicitationResult ──→ capture MCP form submissions
 │
 └─ Stop hook ──────────→ session digest + sync + summary
 │
 ▼
Local SQLite (FTS5 + sqlite-vec)
 │
 ▼ (sync every 30s)
Candengo Vector (cloud)
 │
 ▼
Available on all your devices + team members

Codex session:

code

 │
 ├─ SessionStart hook ──→ inject relevant memory into context
 │
 ├─ MCP tools ──────────→ search, save, inspect, message, stats
 │
 └─ Stop hook ──────────→ session digest + sync + summary

Agent Capability Matrix

Capability	Claude Code	Codex	OpenClaw
MCP server tools	✓	✓	Via skills / MCP
Session-start context injection	✓	✓	Via skill-guided workflow
Stop/session summary hook	✓	✓	Via skill-guided workflow
Per-tool automatic capture	✓	Partial via MCP/manual flows only	Manual / skill-guided
Pre-write Sentinel hook	✓	Not yet exposed by Codex public hooks	Not exposed
Pre-compact reinjection	✓	Not exposed	Not exposed
ElicitationResult capture	✓	Not exposed	Not exposed

See AGENT_SUPPORT.md for detailed comparison.

Features

MCP Tools

The MCP server exposes tools that supported agents can call directly:

Tool	Purpose
`search`	Find relevant observations from memory (hybrid FTS5 + vector)
`timeline`	Chronological context around an observation
`get_observations`	Fetch full details by ID
`save_observation`	Manually save something worth remembering
`install_pack`	Load a curated knowledge pack for your stack
`send_message`	Leave a cross-device or team note
`recent_activity`	Inspect what Engrm captured most recently
`memory_stats`	View high-level capture and sync health

Observation Types

Type	What it captures
`discovery`	Learning about existing systems or codebases
`bugfix`	Something was broken, now fixed
`decision`	Architectural or design choice with rationale
`change`	Meaningful modification (feature, config, docs)
`feature`	New capability or functionality
`refactor`	Code restructured without behavior change
`pattern`	Recurring issue or technique
`digest`	Session summary (auto-generated)

Hybrid Search

Local FTS5 + sqlite-vec (all-MiniLM-L6-v2, 384 dims) combined with Candengo Vector's BGE-M3 semantic search. Results merged via Reciprocal Rank Fusion.

Sentinel

LLM-powered review of every Edit/Write before it executes. Catches security issues, anti-patterns, and drift from team decisions.

code

⚠️ Sentinel: SQL query uses string concatenation instead of parameterized query
   Rule: sql-injection
   (Advisory mode — change allowed)

Built-in rule packs: security, auth, api, react, database.

bash

npx engrm sentinel init-rules  # Install all rule packs
npx engrm sentinel rules        # List available packs

Knowledge Packs

Pre-loaded knowledge for your tech stack. Detected automatically on session start.

Available: typescript-patterns, nextjs-patterns, node-security, python-django, react-gotchas, api-best-practices, web-security

bash

npx engrm install-pack typescript-patterns

Secret Scrubbing

Multi-layer regex scanning for API keys, passwords, tokens, and credentials. Sensitive content is redacted before storage and sync. Custom patterns configurable in ~/.engrm/settings.json.

Retention & Aging

Observations age gracefully: active (30 days, full weight) → aging (0.7x search weight) → archived (compacted into digests) → purged (after 12 months). Pinned observations never age.

Pricing

Free tier stays free forever. No bait-and-switch.

Start with 2 devices and 5,000 observations. Upgrade when you need more.

	Free	Vibe	Pro	Team
Price	£0	£5.99/mo	£9.99/mo	£12.99/seat/mo
Observations	5,000	25,000	100,000	Unlimited
Devices	2	3	5	Unlimited
Cloud sync	✓	✓	✓	✓
Sentinel	—	Advisory (50/day)	Advisory (200/day)	Blocking (unlimited)
Retention	30 days	90 days	1 year	Unlimited
Team namespace	—	—	—	✓

Self-Hosted

Point Engrm at your own Candengo Vector instance:

bash

npx engrm init --url=https://vector.internal.company.com --token=cmt_...

Candengo Vector provides the backend: BGE-M3 hybrid search, multi-tenant namespaces, and team sync. See the Candengo docs for deployment.

Configuration

`~/.engrm/settings.json`

Created by engrm init. Contains API credentials, sync settings, search preferences, secret scrubbing patterns, and Sentinel configuration.

`.engrm-project.json`

Place in your project root to override project identity for non-git projects:

json

{
  "project_id": "internal/design-system",
  "name": "Design System"
}

Agent Auto-Registration

Engrm auto-registers in:

~/.claude.json — MCP server (engrm)
~/.claude/settings.json — 6 lifecycle hooks
~/.codex/config.toml — MCP server (engrm) + codex_hooks feature flag
~/.codex/hooks.json — SessionStart and Stop hooks

Technical Stack

Runtime: TypeScript, runs on Bun (dev) or Node.js 18+ (npm)
Local storage: SQLite via better-sqlite3, FTS5 full-text search, sqlite-vec for embeddings
Embeddings: all-MiniLM-L6-v2 via @xenova/transformers (384 dims, ~23MB)
Remote backend: Candengo Vector (BGE-M3, Qdrant, hybrid dense+sparse search)
MCP: @modelcontextprotocol/sdk (stdio transport)
AI extraction: @anthropic-ai/claude-agent-sdk (optional, for richer observations)

License

FSL-1.1-ALv2 (Functional Source License) — part of the Fair Source movement.

✅ Free to use, modify, and self-host
❌ You cannot offer this as a competing hosted service
✅ Each version converts to Apache 2.0 after 2 years
⚠️ Sentinel is a separate proprietary product

See LICENSE for full terms.

Documentation

Architecture: ARCHITECTURE.md
Contributing: CONTRIBUTING.md
Security: SECURITY.md
Roadmap: ROADMAP.md

Maintainers: run node scripts/check-public-docs.mjs to verify the repo only contains the approved public docs set at the root.

Resources

Community

Found this useful? ⭐ Star this repo to help other developers discover Engrm.

Built by the Engrm team, powered by Candengo Vector.

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "engrm": {
      "command": "npx",
      "args": [
        "-y",
        "engrm@0.4.6"
      ]
    }
  }
}