Skip to content

List Memory Items

Module · Stable

Browse memory items by arrival date and type, as cheap fingerprint rows.

Lists memory items (dropped notes/documents) filtered by arrival-date range and/or document_type, newest first. Each row is a fingerprint (memory_item_id, filename, document_type, uploaded_at, a ~200-char text preview, mentioned entities) — cheap enough to page through without a per-item LLM call. limit defaults to 20; total reports the full matching count so a caller knows when it has paged to the end.

Use when you need to browse memory by time rather than look up something specific — a historical sweep (“everything since 2026-01-01”), a daily digest (“items updated since yesterday”), or triaging a page of recent notes before deciding which ones are worth a full read. Page through with limit/offset, then call Get memory item on the rows worth reading in full.

To read one known memory item by id (e.g. from a “Memory item annotated” trigger), use Get memory item directly. To answer a specific question against the memory graph, use Find in memory. To walk relations from a known anchor entity, use List from memory.

Configured per use: created_after, created_before, document_type, limit, offset.

  • items
  • count
  • total

Auto-generated from the skill registry (load_skills()). Do not edit by hand.