Skip to content
Docs menu

Tool reference · Errors, rules & self-improvement

memory_reflect_now

Runs the background maintenance pass on demand: deduplication and decay, and in full or weekly scope also pattern synthesis, triple extraction, fact merging and enrichment.

local stdio server writes
Caution. full and weekly can take a long time on a large store, and some phases call the configured LLM. quick is the cheap option. Deduplication and decay can archive records.

When to use

  • You saved a lot of memories and want duplicates merged now instead of waiting.
  • You want an up-to-date weekly digest.
  • You want to drain the pending extraction queues before a benchmark.

Parameters

NameTypeDefaultDescription
scope "quick" | "full" | "weekly" "full" quick=dedup only, full=digest+synthesize, weekly=deep analysis

Example

Arguments

{
  "scope": "quick"
}

Result shape

{
  "id": "c0d1e2f3a4b54c6d8e9f0a1b2c3d4e5f",
  "type": "session",
  "scope": "quick",
  "started_at": "2026-09-25T09:00:00Z",
  "completed_at": "2026-09-25T09:00:02Z",
  "digest": {
    "duplicates_merged": 3,
    "decay": {
      "checked": 420,
      "archived": 5,
      "kept": 415
    }
  },
  "synthesis": null,
  "weekly_digest": null
}

full also returns triple_extraction, fact_merge, deep_enrichment and representations. The report is saved to the database.

Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.

Server description

The description the server sends to your agent in tools/list, captured from the v14.7.0 source:

Run reflection (the 'sleep' process). Consolidates knowledge, finds patterns, generates skill proposals, updates self-model.

Found a mistake? Open an issue on GitHub.

Search