Tools

Engrm

Name: Engrm
Rating: 3.5 (1 reviews)
Author: dr12hes

By dr12hes 👁 98 views ▲ 0 votes

Cross-device AI memory for OpenClaw, Claude Code, and Codex. The only memory plugin that syncs across devices and agents. Free tier: 2 devices, 5,000 observations.

Homepage GitHub

Install

openclaw plugins install engrm-openclaw-plugin

Configuration Example

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

README

# Engrm

[![License: FSL-1.1-ALv2](https://img.shields.io/badge/license-FSL--1.1--ALv2-blue)](./LICENSE)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-purple)](https://modelcontextprotocol.io)

**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](https://engrm.dev) • [Documentation](https://engrm.dev/developers) • [Blog](https://engrm.dev/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 →](https://engrm.dev/blog/engrm-openclaw-cross-device-memory)

---

## 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 →](https://engrm.dev/blog/engrm-openclaw-cross-device-memory)

### 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

```
━━━ 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
```

```
Engrm Status

  User:        david
  Email:       [email protected]
  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:**
```
 │
 ├─ 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:**
```
 │
 ├─ 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](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.

```
⚠️ 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** | — | — | — | ✓ |

Sign up at [engrm.dev](https://engrm.dev).

---

## Self-Hosted

Point Engrm at your own [Candengo Vector](https://www.candengo.com) 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](https://www.candengo.com/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` f

... (truncated)

tools