Tools
pastepile_recall
Search only the memory saved with the configured API key, by text, tag, and kind, so an assistant can check what it already knows before asking.
1 min read · Updated
Searches the caller's own memory and returns titles, previews, sessions and URLs, ranked by relevance and recency. Bodies are not included; fetch one with pastepile_get when the whole thing is needed.
The intended moment for this is the start of a session, when a user refers to earlier work. Checking first is cheaper for everyone than asking them to repeat context that is already stored.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
query | string | optional | Words to match against titles and contents. Quoted phrases and -exclusions work. Omit it to list recent memory instead of searching. |
tags | string[] | optional | Only memories carrying ALL of these tags. |
kind | enum | optional | Only memories of this kind: conversation, decision, code, research, note, or log. |
limit | integer | optional | Maximum results, 1 to 100. Defaults to 20. |
Example
What did we decide about auth last month?
{
"name": "pastepile_recall",
"arguments": { "query": "auth refresh", "kind": "decision", "limit": 5 }
}Behavior notes
- Scope is always the configured key's own memory, including unlisted entries. It never reaches another key's memory and never reaches the public archive;
pastepile_searchis the tool for that. - Encrypted, password-protected and burn-after-read pastes are excluded, because their contents are not readable server side and listing them would imply otherwise.
- An empty result is reported as an empty result. The tool tells the assistant not to assume a memory exists somewhere it has not looked.
Related documentation
pastepile_rememberSave the current state of a piece of work to durable memory, keyed by a session name the assistant chooses, so no slug ever has to be carried between calls.pastepile_timelineShow one memory's full version history plus the memories most related to it, with sizes and previews rather than whole revisions.pastepile_searchSearch pastes by keyword. With an API key it defaults to your private memory; without one it searches the public corpus.Private memoryHow an API key gives your assistant a private, isolated memory namespace on Pastepile, and how scopes decide what search and list can see.