v1.8.0 v2.0.0

high risk

refactoringhq/tolariaSep 16, 2026 → Sep 18, 20262 days between releases

What's New

Migrated from ChatbotX v1.8.0 to Engram v2.0.0 with project-aware memory and Cloud replication.

Breaking Changes

  • Go module path changed to `github.com/Gentleman-Programming/engram/v2`.
  • Read scoping behavior changed: omitted project selectors now resolve the canonical current project.
  • Cloud sync is strictly project-scoped; `engram sync --cloud --all` is rejected.
  • Cloud servers now require `ENGRAM_CLOUD_ALLOWED_PROJECTS` and a non-default `ENGRAM_JWT_SECRET`.

New Features

  • Project-aware memory and ownership with consistent identity resolution across CLI and Git.
  • Optional Cloud replication with managed access, dashboard, and token management.
  • Richer local memory with FTS5 search, conflict detection, and review cycles.
  • Expanded agent integrations for Claude Code, OpenCode, and various MCP clients.
  • Added `mem_current_project` and project management commands for listing and merging.

Improvements

  • Data-integrity hardening and reliability improvements.
  • Diagnostic tools like `engram doctor` for troubleshooting.
  • Improved Bubble Tea TUI and compact context output.
  • Backup export/import preserves pinned observations and memory relations.
  • Runtime-bound session attribution prevents writes from being assigned to the wrong session.

Bug Fixes

  • Runtime-bound session attribution prevents writes from being assigned to the wrong session.
  • Project-scoped reads behave consistently across CLI, MCP, HTTP, and export.
  • Conflict detection and memory relations tools.

Upgrade Notes

This release represents a major migration from the ChatbotX project to Engram v2.0.0. You must update your Go module path and configuration to support project-scoped Cloud replication. Ensure you set the required `ENGRAM_CLOUD_ALLOWED_PROJECTS` and `ENGRAM_JWT_SECRET` environment variables.

The Two Releases

v1.8.0

v1.8.0

Sep 16, 2026· 1 month ago

This release enhances API security by scoping public APIs to workspace tokens, introduces new automation features like comment tracking and a Threads channel, and improves the MCP surface with agent-first capabilities.

Full release notes
v2.0.0

v2.0.0

Sep 18, 2026· 1 month ago

Engram 2.0.0 is the first stable release of the v2 line, featuring 462 commits that introduce project-aware memory, advanced agent integrations, relation-aware retrieval, optional Cloud replication, and managed access.

Full release notes