search_memory
Search the cross-assistant journal by keyword (case-insensitive substring over entry content) across ALL dates. Use it when the user asks about a specific past topic (「あの件どうなったっけ」) and before answering what the current state of something is. Current decision/profile entries come first, then newest first. Each result has id (pass it to add_memory supersedes when the entry is outdated), belongs_to, visibility, confidence. kinds (e.g. ['decision']), tags (project/topic — the most reliable) and sources ('terminal' | 'claude-web' | 'chatgpt') narrow the hits; belongs_to narrows to named labels (a filter, not access control; unfiled entries only with include_unfiled: true, and only filed entries match otherwise — combine with tags). Only current entries by default — include_superseded: true shows how something changed over time.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Substring to look for in entry content (case-insensitive). | |
| tags | No | Entries carrying at least one of these tags. The most reliable way to narrow by project/topic: tags are what writers actually attach (e.g. 'AccountHub', 'GTM', 'handoff'). | |
| kinds | No | Only these kinds — e.g. ['decision'] for decisions only ('activity' | 'learning' | 'decision' | 'profile'). | |
| limit | No | Max entries to return (default 20). | |
| sources | No | Only entries written from these surfaces: 'terminal' | 'claude-web' | 'chatgpt'. | |
| belongs_to | No | Read only entries filed under these `belongs_to` labels (NAMES from `belongs_to_options` in list_accounts / the digest, e.g. ['プライベート']). A topic FILTER, not access control — who may read an entry is `visibility`. With `belongs_to`, unfiled entries are left out unless include_unfiled is true. Unknown names are refused with the valid list. | |
| visibilities | No | Only entries with these audiences — e.g. ['private_self','shared_1on1'] to leave out 'company' / 'hr_private'. | |
| include_unfiled | No | Also include entries not filed under any `belongs_to` label. With `belongs_to`: default false (only the named labels). Without `belongs_to`: default true; pass false to drop unfiled entries. | |
| include_superseded | No | Also search superseded (no-longer-current) entries — old states of a memory_key that have since been replaced. Default false — only turn this on to look at history (e.g. "how did this decision change over time"), never to answer "what is the current state of X". | |
| include_operational | No | Also search scheduled-job bookkeeping (checkpoints, processed ids, "nothing new"). Default false — only turn it on to debug a collection job, never to answer a question about the work itself. |