Lethe v0.4.0 — One container, three memory modes, every agent
Lethe v0.4.0
One container, three memory modes, every agent.
Lethe is the persistent memory platform for AI agents — ChatGPT, Claude, Claude Code, Cursor, VS Code agents, OpenClaw, custom MCP clients, local IDE assistants, and backend services. One image runs everything; pick the mode with LETHE_MODE:
- Legacy — session memory: events, summaries, checkpoints, interruption recovery, task tracking (the OpenClaw experience).
- Git — versioned durable memory: changesets, refs, branching, reviewed merges, immutable history.
- Hybrid — both memory systems in one instance.
What's in this release
- Memory Git (
memory_git/v1) — durable, shared, review-gated memory using Git semantics (not filesystem git). Owned refs, proposals, independent review, and replay-proof signed merges (memory-git-merge/v2) with exact context projection at any head. - Treehouse UI — a GitHub-style memory repository in the browser: accepted memory, changeset log with shared ancestry, branches with real protection badges, commit-level op diffs, project switcher, and a Sessions ↔ Memory Git switcher. Built into the container in git and hybrid mode.
- Charon (companion,
ghcr.io/openlethe/charon) — the authorization and governance gateway for shared deployments: OAuth S256 PKCE + audience-bound Obols, scoped principals, fail-closed audit ledger. Optional; git mode works without it. - Docs — rebuilt: a 14-topic ordered set in
docs/and live at openlethe.com/docs.
Install
docker pull ghcr.io/openlethe/lethe:latest # or :0.4.0 — multi-arch (linux/amd64 + arm64)
# legacy mode
docker run -d -p 127.0.0.1:18483:18483 -v ./lethe-data:/data ghcr.io/openlethe/lethe:latest
# git mode (pulls the same published image)
sh scripts/prepare-local-memory-git-env.sh
docker compose -f docker-compose.git.yml --env-file .env.git up -d
# hybrid mode
docker run -d -p 127.0.0.1:18483:18483 -v ./lethe-data:/data -e LETHE_MODE=hybrid ghcr.io/openlethe/lethe:latestCompatibility
| Component | Release |
|---|---|
| Lethe | v0.4.0 |
| Charon | v0.1.0-beta.1 |
| Memory Git schema | memory_git/v1 |
| Merge authorization | memory-git-merge/v2 |
Migration from v0.3.x is automatic (additive migration 008). Details: docs/migration.md and the full documentation set.