Parallel Memory

14 skills · 50 min

• Inspect memory only when prior Parallel work may help fulfill the request or the user asks to retrieve, evict, or clear it.
• Memory results are excerpts from past runs; fetch the source run for full records, and launch a fresh run when current information is required.

Choose the operation

Use the CLI

Use parallel-cli memory for retrieve, evict, and clear operations.

• If memory is not eligible, report the returned reason; it distinguishes rollout, organization settings, account opt-in, and key eligibility.
• On a key-eligibility error, tell the user to reauthenticate.

Retrieve memory

Form a short semantic query that describes the prior work to find. Apply filters when they help. Empty results is a successful retrieval with no matches, not an error.

• Set kind to task, monitor, or findall when it clearly narrows the retrieval.
• Set since for an explicit timestamp boundary (RFC 3339, e.g. 2026-08-01T00:00:00Z).
• Omit query when retrieving recent memories rather than a topic.

Retrieve by query:

For recent memories:

Use results

Available fields vary by kind:

• task: use id, updated_at, input_excerpt, and output_excerpt.

• monitor: use the monitor id, status, query excerpt, and matching event IDs, timestamps, and excerpts.

• findall: use id, updated_at, objective excerpt, and matched_count.

• Fetch the original Task result, Monitor events, or FindAll result when exact output, entities, citations, or provenance matter.

• Summarize the useful findings and unresolved questions.

• Lead with what the prior work established, then list the contributing saved runs with kind, ID, and timestamp.

• Distinguish recalled information from any fresh verification.

• Parallel runs do not consult Memory. If recalled information may be useful, include the relevant details in the new run’s input.

Expect ingestion to be asynchronous. Do not promise that a newly completed run will be immediately retrievable.

Evict or clear memory

Evict a single run from your personal Memory, or clear it entirely. These do not delete the underlying Parallel runs. Ask for confirmation before clearing unless the user already asked for it.