PMB

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_brief and overview are now actually exposed to agents (the tool-profile filter was silently dropping them - they returned "Unknown tool").
• session_brief now 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, …