Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agentmemory",
"version": "0.9.32",
"version": "0.9.33",
"description": "Persistent memory for Cursor: auto-captures sessions, prompts, and tool use via hooks, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs entirely on your machine.",
"author": {
"name": "Rohit Ghumare",
Expand Down
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,17 +101,17 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).

## Testing

- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,600+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.
- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,700+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.
- Before any npm publish: `npm run release:gate` must pass. It installs the packed tarballs into a clean home and runs capture, recovery, restart, export/import, MCP and status checks against the installed CLI (see CONTRIBUTING.md, Release process)
- Mock pattern: `vi.mock("iii-sdk")` with mock `sdk.trigger`, `kv.get/set/list`
- Test files go in `test/` with `.test.ts` extension
- Follow existing patterns in `test/crystallize.test.ts` for function tests

## Current Stats (v0.9.32)
## Current Stats (v0.9.33)

- 54 MCP tools visible by default; `AGENTMEMORY_TOOLS=core` selects 8 essentials
- 147 REST endpoints
- 6 MCP resources, 3 MCP prompts
- 12 hooks, 17 skills
- 322+ iii functions
- 4,600+ tests
- 4,700+ tests
32 changes: 31 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,36 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

## [Unreleased]

## [0.9.33] — 2026-11-09

### Upgrade notes

- agentmemory now pins iii 0.25.1 (engine, `iii-sdk` and `@iii-dev/helpers`) with state 0.22.22 and http 0.22.8. The first start after the upgrade installs them (#1634, #1694).
- `GET /agentmemory/memories` and `GET /agentmemory/relations` without `limit` return 413 with a paging hint when the full list is larger than the transport limit, as `/semantic` and `/procedural` already did. Use `?limit=N` and `nextCursor`. The viewer and CLI already page (#1636).
- Docker installs: the root and Coolify Compose files now forward `AGENTMEMORY_LLM_PROVIDER`. A provider key alone does not turn on LLM features; set `AGENTMEMORY_LLM_PROVIDER` to the provider whose key you configured. Docker installs that set only a key ran without LLM summaries since 0.9.32 (#1700).

### Added

- **State scopes above 64 MiB keep working.** Whole-scope reads page through `state::list_keys` instead of one frame, and mesh export pages when given `limit` or `cursor` (#1636). The transport cap is 64 MiB, up from 16 MiB (#1634).
- `GET /agentmemory/sessions` filters by `startedAfter`, `startedBefore`, `endedAfter` and `endedBefore` (#1527 by @yxtay).
- `AGENTMEMORY_SUMMARY_TIMEOUT_MS` sets the summary budget for large chunked sessions on slow or local LLMs (default 120 s) (#1689).
- `memory_diagnose` and `memory_heal` have a `facets` category that finds and removes facets whose target was deleted (#1698).

### Fixed

- **Search:** saved memories are no longer capped at three per search (#1696). Evicted memories leave the search indexes (#1601 by @DimitriChrysafis). Boot detects historical gaps in a partially embedded vector index (#1687 by @mvanhorn). CLIP text queries use the CLIP text tower, so text-to-image search returns matching images (#1250 by @anhtahaylove).
- **Hooks:** PreToolUse sends its context in the hook envelope, so the model sees it (#1693). Enrichment is scoped to the current project (#1220 by @devon3000). The Claude Code SessionEnd hook has time to finish (#1692). Captured text is redacted before it is cut to length, and compound secret key names are redacted (#1695, #1701). Cursor subagent stop type and summary fields are mapped (#1684 by @mothieras).
- **Providers:** placeholder keys such as `sk-...` count as unset when agentmemory picks the LLM provider (#1588 by @dmazhukov). A success clears the circuit breaker failure count (#1350 by @redeye1011), and content-filter rejections no longer open the breaker (#1277 by @dKaulig).
- The MCP shim waits 190 s for proxied calls instead of 15 s, past the server's 180 s limit, so long consolidate and reflect calls finish (#1691). `memory_action_create` records the creating agent (#1697).
- Consolidation keeps provenance and version heads across retries, and saved pattern memories reach the procedural tier (#1545, #1690). Reflection bounds its evidence and insight responses and keeps other projects' crystals out of a scoped reflection (#1544).
- `health` reports CPU relative to the machine's cores, not one core (#1286 by @DanielCarmingham).
- `agentmemory demo` stops the Compose workers it started on Windows (#1688 by @Mike-Animal-Counseling). Generated Compose values keep newlines (#1708 by @zhichao-poper).
- `agentmemory connect` honors `CLAUDE_CONFIG_DIR` for Claude Code detection, MCP configuration and hooks (#1703 by @mothieras).

### Infrastructure

- `@agentmemory/pi` 0.1.1 and `@agentmemory/fs-watcher` 0.2.0 (#1683). GitHub Actions bumps (#967, #1473). Config reference env count regenerated (#1705). The Windows release gate fails when its leftover-process query fails (#1711), and the CLIP tests check both towers (#1712).

## [0.9.32] — 2026-11-04

### Upgrade notes
Expand Down Expand Up @@ -343,7 +373,7 @@ Wave release closing several breaking regressions reported against v0.9.26, plus
- `/agentmemory:forget` skill still calls `memory_governance_delete` which only touches `KV.memories` and never observations ([#833](https://github.com/rohitg00/agentmemory/issues/833)). Skill rewrite + new `memory_forget` MCP tool tracked separately.
- `crypto.randomUUID()` global-only on Node <19 ([#715](https://github.com/rohitg00/agentmemory/issues/715)). Drop-in import fix tracked.

[0.9.32]: https://github.com/rohitg00/agentmemory/compare/v0.9.31...v0.9.32
[0.9.33]: https://github.com/rohitg00/agentmemory/compare/v0.9.32...v0.9.33
[0.9.32]: https://github.com/rohitg00/agentmemory/compare/v0.9.31...v0.9.32
[0.9.31]: https://github.com/rohitg00/agentmemory/compare/v0.9.30...v0.9.31
[0.9.30]: https://github.com/rohitg00/agentmemory/compare/v0.9.29...v0.9.30
Expand Down
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-hooks.svg"><img src="assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-deps.svg"><img src="assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="4,600+ tests passing" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="4,700+ tests passing" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -332,14 +332,14 @@ Latest release notes: [CHANGELOG.md](CHANGELOG.md).

---

### What's new in 0.9.32
### What's new in 0.9.33

- **Providers are opt-in:** a key alone sends nothing out. Set `AGENTMEMORY_LLM_PROVIDER` for LLM features and `EMBEDDING_PROVIDER` for cloud embeddings.
- **Native Windows works:** Worker Compose starts, iii installs itself, and `doctor` never waits on a prompt in scripts.
- **Reliable boot:** agentmemory waits for the state worker, so slow starts keep their search index and vectors.
- **Better recall:** CJK queries, scoped smart-search and project isolation fixes.
- **Large stores keep working:** state reads page, so scopes above 64 MiB no longer fail, on iii 0.25.1.
- **Better recall:** saved memories are no longer capped at three per search, and evicted memories leave the indexes.
- **Hooks reach the model:** PreToolUse context arrives in the hook envelope, scoped to the current project.
- **Steadier providers:** placeholder keys count as unset, and the circuit breaker resets on success.

[Release notes and contributor credits](https://github.com/rohitg00/agentmemory/releases/tag/v0.9.32).
[Release notes and contributor credits](https://github.com/rohitg00/agentmemory/releases/tag/v0.9.33).

<h2 id="benchmarks"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-benchmarks.svg"><img src="assets/tags/section-benchmarks.svg" alt="Benchmarks" height="32" /></picture></h2>

Expand Down Expand Up @@ -1313,7 +1313,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.ar-SA.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ tests passing" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ tests passing" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.bn-BD.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP টুল" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 অটো হুক" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 এক্সটার্নাল ডিবি" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ টেস্ট পাস" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ টেস্ট পাস" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1257,7 +1257,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.cs-CZ.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP nástrojů" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatických hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 externích databází" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ testů úspěšně proběhlo" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ testů úspěšně proběhlo" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.da-DK.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-værktøjer" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatiske hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 eksterne databaser" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ beståede tests" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ beståede tests" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.de-DE.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-Tools" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 Auto-Hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 externe DBs" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ bestandene Tests" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ bestandene Tests" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.el-GR.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 εργαλεία MCP" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 αυτόματα hooks" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 εξωτερικές βάσεις δεδομένων" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ επιτυχημένες δοκιμές" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ επιτυχημένες δοκιμές" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.es-ES.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 tools MCP" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hooks automáticos" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 bases de datos externas" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ tests superados" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ tests superados" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1245,7 +1245,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
4 changes: 2 additions & 2 deletions READMEs/README.fi-FI.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-työkalua" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automaattista hookia" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 ulkoista tietokantaa" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,600+ testiä läpäisty" height="38" /></picture>
<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="4,700+ testiä läpäisty" height="38" /></picture>
</p>

<p align="center">
Expand Down Expand Up @@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
npm test # 4,600+ tests
npm test # 4,700+ tests
npm run test:integration # API tests (requires running services)
```

Expand Down
Loading
Loading