v0.2.5 - Active-mode agent memory + session continuity
PMB is local-first persistent memory for AI coding agents (MCP server) - fully offline, no API keys, no LLM in the recall hot path.
This release makes agents actually use that memory: they log their own work as they go, and re-orient after a long session's context window compacts.
Highlights
🤖 Agents log their own work - pmb connect <agent> --active
Proactive-logging rules: the agent records its own decisions, completed work, lessons, failures and goals while coding - no "remember" needed. Recall stays lazy (zero overhead on general questions). Per-category toggles via pmb config / pmb tune.
🧵 Session continuity - session_brief
New session_brief MCP tool + pmb session brief: a digest of what was decided / done / learned this session, so an agent that lost its context can pick the thread back up instead of re-asking you.
🧠 Self-improvement loop
With agent.apply_lessons, the agent recalls and applies past lessons/failures before a task -bso it stops repeating the same mistakes in a project over time.
🔭 overview - "what do I know about X"
New overview MCP tool + pmb overview "<topic>": structured synthesis (key facts & decisions, lessons, failures, goals, timeline, related topics) in one call.
🐛 MCP correctness fixes
session_briefandovervieware now actually exposed to agents (the tool-profile filter was silently dropping them - they returned "Unknown tool").session_briefnow covers the whole session (facts/goals/lessons, not just activities) and classifies decisions/done correctly.- Tool-profile filter is event-loop-safe.
📅 Answer-ready recall
- Every recall result carries a human-readable resolved
date(event time → session → creation), so agents answer "when…?" without epoch math. - Temporal validity windows +
keyed_fact_as_of()- query what was true at a past time.
🧪 Tests & CI · 📚 Docs
End-to-end MCP tests (test_mcp_e2e.py), test_connect_active.py, test_jscore_levers.py. CI matrix now runs ubuntu + windows + macOS. New docs/COMMANDS.md full command reference.
Install
pip install -U pmb-ai
pmb connect claude-code --active # or: codex, cursor, windsurf, …