Breaking change: an API key alone no longer turns on an outside LLM or embedding provider. Read Breaking before upgrading.
Breaking
- LLM summaries, compression, consolidation and reflection need
AGENTMEMORY_LLM_PROVIDER=anthropic|openai|gemini|openrouter|minimaxplus that key; boot,doctor,statusand the viewer print the line to add (#1664) - Cloud embeddings need
EMBEDDING_PROVIDER=<name>;localstays on-device, unset means BM25 and graph only (#1664) OPENAI_API_KEY_FOR_LLMis removed (#1664)- Hooks send nothing to a remote plain
http://server; use HTTPS for a remote server (#1664) - PreCompact injects stored memory only with
AGENTMEMORY_INJECT_CONTEXT=true(#1664)
Added
- iii installs itself on native Windows, with SHA-256 verification (#1670)
- Claude Code plugin settings for the server URL and secret; secret kept in the system credential store (#1664)
- MCP tool annotations (
readOnlyHint,destructiveHint) and a privacy policy at https://agent-memory.dev/privacy (#1664) sourceIdsonmemory_lesson_save(#1661)- Official listings: OpenAI plugin directory for Codex (skills, pair with
agentmemory connect codex), Hermes plugin catalog (hermes plugins install agentmemory) and ClawHub (openclaw plugins install clawhub:agentmemory) - MCP shim crash log
mcp-crash.log, saved store before exit (#1662, #1674) - Docker Hub image
ghumarerohit/agentmemory:<version>andlatestfor linux/amd64 and linux/arm64, published on each release (#1677)
Fixed
- Copilot CLI subagent reports keep their reply and are stored once (#1599)
- Worker Compose starts on native Windows;
stopwaits for every worker (#1641) - No hidden install prompt or hang on a slow
iii --versionprobe on Windows (#1658) - Boot waits for the state worker, so slow starts keep the keyword index and vectors (#1627, #1626, #1660)
- Stale compose PID after a reboot no longer crash-loops (#1622)
- Docker image keeps local embedding dependencies (#1651)
doctornever prompts without a terminal or withCIset (#1671); no SDK debug lines instatus/stop(#1672)- Slot tools hidden and guarded when
AGENTMEMORY_SLOTSis off (#1659) - CJK recall (#1553), scoped smart-search ranking (#1669), project isolation (#1647), memory types in search responses (#1646)
- OpenAI reply cut at
max_tokensfails over instead of being stored (#1495) - Orphaned index generations reclaimed (#1256); bounded MCP graph stats (#1260)
- Facet cleanup on deletes (#1642), session sweep (#1645), surrogate-safe hook truncation (#1598), Hermes git probe stdin (#1663), Cline MCP path (#1633)
- Superseded memories sync to mesh peers (#1665), pi lesson recall (#1605),
npm run buildon Windows cmd.exe (#1362),.env.examplewording (#1675)
Packages
@agentmemory/pi0.1.1: full lesson read by id, scoped to its project (#1605)@agentmemory/fs-watcher0.2.0: first watcher release since April, with preview redaction of private keys and JWTs, auth by default, confined paths and linked-worktree project scope
Known issues
- Windows:
stoptakes about 60 s and empty console windows open per start (iii-hq/iii#2430)
Contributors
Thanks @cbsincool, @Tyxiel, @pei711, @mothieras, @akushonkamen, @dmazhukov, @reevesc88, @Rex57, @inix-x, @xh123637, @egantz, @YeChenglin8888 and @mattamundson for the fixes in this release, and to everyone who reported and diagnosed the Windows and boot issues.
Full changelog: v0.9.31...v0.9.32