v0.1.7

Engram v0.1.7 — Setup Message Fix

Updated the post-install message shown after engram setup opencode to correctly reflect that MCP registration is now automatic (since v0.1.6).

What Changed

• Post-install message no longer tells users to manually add the MCP block — it already happened automatically

v0.1.6

Engram v0.1.6 — Auto-Register MCP in OpenCode

engram setup opencode now automatically registers the Engram MCP server in your opencode.json config — no manual editing required.

What Changed

• Auto MCP registration — the setup command writes the MCP server entry directly into the OpenCode config file
• Previously, users had to manually add the MCP block after running setup

v0.1.5

Engram v0.1.5 — Export All Projects

Added --all flag to engram export so you can back up memories from every project in a single command.

What Changed

• engram export --all exports observations and sessions from all projects, not just the current one
• Default behavior unchanged — without --all, export scopes to the current project

v0.1.4

What's New

Memory Protocol injection in session hooks

Claude Code now receives the Memory Protocol instructions at session start and post-compaction, not just as a passive skill file. This fixes the issue where Claude Code wouldn't proactively save memories unless explicitly asked.

Before: The protocol lived only in skills/memory/SKILL.md — Claude read it passively and often forgot to save decisions, conventions, and discoveries.

After: The protocol is injected as additionalContext every session start, with explicit triggers:

• Save after decisions, conventions, bug fixes, discoveries
• Self-check prompt: "Did I just make a decision or learn something? → mem_save NOW"
• Session close protocol always present

Changes

• SKILL.md — Rewritten with explicit trigger categories and self-check prompt
• session-start.sh — Injects Memory Protocol + memory context at session start
• post-compaction.sh — Injects Memory Protocol + compaction recovery instruction + context

Update

brew upgrade engram
# Then in Claude Code:
claude plugin update engram

Changelog

• cf5e00a feat(plugin): inject Memory Protocol in session hooks for proactive saves

v0.1.3

What's New

Spinner during plugin installation

The TUI setup screen now shows an animated spinner with a contextual message while installing agent plugins, replacing the silent gap between pressing enter and seeing the result.

• Visual feedback — spinner animates during the entire install process
• Contextual messages — shows what's happening (file copy for OpenCode, marketplace commands for Claude Code)
• Input blocking — keys are disabled during install to prevent double-triggers

Update via Homebrew

brew upgrade engram

Changelog

• 2abf1ef feat(tui): add spinner during plugin installation

v0.1.2

What's New

Claude Code Marketplace Integration

Claude Code plugin is now installed via the native marketplace instead of embedded files. This means:

• Lighter binary — no more embedded claude-code plugin files in the engram binary
• Independent updates — plugin updates ship from the repo without needing a new engram release
• Proper integration — claude plugin list shows engram correctly

Install Claude Code plugin

# One command via engram CLI
engram setup claude-code

# Or manually
claude plugin marketplace add Gentleman-Programming/engram
claude plugin install engram

Update via Homebrew

brew upgrade engram

Changelog

• c333a15 feat: add Claude Code marketplace manifest for plugin installation
• 793042b docs: update README with Claude Code marketplace install instructions
• 68315b9 docs: add prerequisite callout for binary install in OpenCode and Claude Code sections
• 8162450 refactor: use claude marketplace for plugin install, remove embedded claude-code files

v0.1.1

What's New in v0.1.1

✨ engram setup — One-command plugin installation

Install the agent plugin directly from the binary — no repo clone needed:

# Interactive (asks which agent)
engram setup

# Direct
engram setup opencode
engram setup claude-code

Also available in the TUI: Dashboard → Setup agent plugin

Plugin files are embedded in the binary via go:embed, so this works from Homebrew, binary download, or source build.

🔌 Claude Code Plugin

Full native plugin for Claude Code with:

• SessionStart hooks — auto-starts server, creates session, imports git-synced chunks, injects previous context
• Post-compaction recovery — injects context + instructs agent to persist compacted summary
• Memory Protocol skill — strict rules for when to save, search, close sessions, and recover after compaction
• MCP server registration via .mcp.json

🔧 Improvements

• Sync defaults to current project — engram sync in ~/work/my-project only exports memories for my-project, not the entire DB. Override with --project.
• Fixed compaction persistence — replaced empty checkpoint with instruction to the compressor to persist the real compacted summary via mem_session_summary
• Removed unreliable session status — the status field was removed from sessions (stayed "active" forever without a heartbeat). Will reintroduce with a proper heartbeat mechanism.

Changelog

• 6b80f06 feat: add 'engram setup' command and TUI screen for agent plugin installation
• 75f616e feat: add Claude Code plugin with hooks, skills, and MCP registration
• 14c33f9 feat: sync defaults to current directory as project filter
• 7d25528 fix: replace empty compaction checkpoint with instruction to persist compacted summary
• 2c56b6d refactor: remove session status field — unreliable without heartbeat

Full Diff: v0.1.0...v0.1.1

v0.1.0

Engram v0.1.0 — Initial Release

The first public release of Engram — a persistent memory system for AI coding agents.

What's Included

• SQLite-backed memory store with full-text search (FTS5) for observations, sessions, and user prompts
• MCP server (stdio transport) exposing memory tools to any MCP-compatible agent
• HTTP API for direct integration (GET/POST observations, sessions, prompts, search, context)
• Terminal UI (engram tui) with project browsing, session inspection, and observation search
• Git-based sync with chunked compressed JSONL exports and manifest tracking
• Auto-import of synced chunks on startup
• OpenCode plugin with system prompt injection and compaction recovery
• Memory Protocol — strict rules for when agents should save, search, and close sessions

Install

brew install gentleman-programming/tap/engram