Skip to content

Lethe v0.4.0 — One container, three memory modes, every agent

Choose a tag to compare

@github-actions github-actions released this 18 Jul 21:10
· 10 commits to main since this release

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:latest

Compatibility

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.