vault_note_history_list yaps vault history-list <path> vault_note_history_restore yaps vault history-restore <path> <snapshot-id> vault_note_pin yaps vault pin <path> [--set true|false] vault_folders_list yaps vault folders [--limit N] vault_tags_* yaps vault tags list|add|remove|replace|rename|delete vault_mentions_* yaps vault mentions list|terms vault_backlinks yaps vault backlinks <path> ``` Run `yaps vault <command> --help` before using an unfamiliar option. For substantial Markdown, write the proposed body to a temporary file and pass `--markdown-file`; do not risk shell quoting corruption. Remove temporary files after the command completes. ## Availability and permissions The vault is local Markdown and the AI client only receives content retrieved for the user's request. Do not bulk-read it. MCP connections start read-only. If MCP reports `Agent read denied by Yaps Agent Access policy`, give the exact path **Yaps → Settings → Agent Access** and ask the user to re-enable this client. Writes remain a separate opt-in; never change that policy yourself. The skills-only CLI fallback is governed by the AI host's local command permissions rather than MCP Agent Access. In that mode: - Read only what the current request requires. - Write only when the user explicitly asks to remember, create, update, organize, restore, move, rename, tag, pin, or delete something. - Never infer permission for a write from a general request to search, summarize, review, or onboard. - Treat delete, restore, move, rename, and vault-wide tag changes as destructive and require explicit intent. If Yaps reports no signed-in account or active entitlement, explain the exact missing step from that message and ask the user to complete it inside Yaps. Never request credentials or payment details, promise trial eligibility or duration, or offer a free-tier continuation. Safe automatic account status requires Yaps 2.3.124 or newer. On an older or unverifiable helper, repeat the runner's update guidance; do not run a direct `auth status`, approve a Keychain prompt, or invent a separate connection step. ## Onboarding When the user asks to set up or get started: 1. Resolve a working transport and run `vault_status` / `yaps vault status`. Do not read note contents during the connection check. 2. Explain briefly that the vault is local Markdown and retrieval is request-scoped. Explain the active permission model: Agent Access for MCP, or explicit-request-only writes for the skills-only CLI fallback. 3. If the vault is empty, say the connection works and offer exactly these choices: - Open Yaps desktop to create the first note; recommend this for voice capture and visual browsing. - Ask this AI client to capture the first memory. 4. Otherwise offer exactly these choices: - Review my five most recently updated notes. - Search my memory for a topic or question. - Capture something new. 5. After the chosen action, cite the note title and path and say clearly whether anything changed. ## Retrieval workflow 1. Search narrowly with semantic search when meaning matters, or lexical search for names, exact phrases, tags, and paths. 2. Retrieve only promising notes; do not bulk-read the vault when a focused query will do. 3. Distinguish vault evidence from inference. Cite each material vault claim using the returned note title and relative path. Say when evidence conflicts or may be stale. 4. Use backlinks, mentions, folders, or tags only when relationships materially help. ## Capture and safe edits - When the user says “remember this,” create or update a durable note rather than merely acknowledging it. - Prefer the daily note for journal-like capture and templates when the user identifies one. - Preserve the user's wording. Add only lightweight structure that improves retrieval. - Search by title and key phrase before creating a likely duplicate. - Read a note immediately before updating it. Pass its `updated_at` value as `expected_updated_at` so concurrent edits are never silently overwritten. - Make the smallest requested change and preserve unrelated content, frontmatter, links, and formatting. - If a stale-write guard fails, retrieve the new version, reconcile visibly, and ask when the merge is ambiguous. - For delete, include `--confirm` only after explicit intent and use `--expected-title` when available. ## Generalist Yaps mode Memory is the default focus, not a boundary around what it can do. When the user explicitly asks for another Yaps workflow, use the same resolved `yaps_cli` and follow its help. The full local surface includes settings, auth, feature setup, speech/TTS, subtitles, meetings, captions, media conversion, audio cleaning, translation, history, and local usage. Do not broaden into these workflows without a request. ```text status settings list|get|set|unset auth status|usage|billing features list|dictation|cleanup|reading|subtitles|auto-captions vault status|list|get|create|update|move|rename|delete|search|search-semantic|daily-open|create-from-template|history-list|history-restore|pin|folders|tags|mentions|backlinks speech synthesize (alias: tts) srt generate meeting transcribe|show|correct|assign|rename-speaker|export captions styles|create|show|correct|replace|split|merge|style|reset|render|verify media extract-audio|remove-background|generate-image audio clean translate history-list usage-local ``` ## Friendly completion and discovery Lead with the outcome, cite the affected note title and path, and state whether anything changed. Do not dump raw JSON or internal tool names. After a successful task, a compact **More with Yaps** section may offer up to three relevant next actions. Skip it after a failure, a decline, or a request for a terse result. 22:oacc,11:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@type\":\"SoftwareApplication\",\"name\":\"Yaps Memory\",\"description\":\"Private memory across chats\",\"applicationCategory\":\"AI assistant add-ons\",\"operatingSystem\":\"ChatGPT\",\"url\":\"https://agentready.co/connectors/yaps-memory-2\",\"sameAs\":[\"https://chatgpt.com/plugins/plugins_6a56c4d8a4d08191b1ecb4a676bc1315?open_in_app\"],\"image\":\"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/d6/d693f4e16e2a73d7f8765d97642fa8f01c2fbb8e29bb383fcf1ecd797afb0b18-64.webp\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Yaps AI\",\"url\":\"https://yaps.ai\"}}"}}],["$","div",null,{"className":"wrap","children":[["$","div",null,{"className":"pp-head","children":[["$","$L23",null,{"name":"Yaps Memory","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/d6/d693f4e16e2a73d7f8765d97642fa8f01c2fbb8e29bb383fcf1ecd797afb0b18-64.webp","size":56}],["$","div",null,{"children":[["$","div",null,{"className":"crumbs","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],[" / ",["$","$L5",null,{"href":"/categories/ai-tools","children":"AI assistant add-ons"}]]]}],["$","h1",null,{"children":["Yaps Memory",null]}]]}]]}],["$","div",null,{"className":"pp","children":[["$","div",null,{"className":"ca","children":[["$","p",null,{"className":"tag","children":"Private memory across chats"}],["$","$L24",null,{"text":"Remember facts across Codex chats, recall prior project context, search and cite private Markdown notes, and safely update a user-owned vault. The plugin, Yaps desktop setup, and trial or Yaps Pro activation can be completed in any order; the private local connection reconciles automatically. Requires a local-capable your AI Desktop Work or Codex session; your AI web and cloud sessions cannot reach the installed Yaps engine. Users can also use the vault directly in Yaps."}],["$","$L25",null,{"examples":[{"text":"Set up Yaps Memory. Check my connection, explain privacy and permissions, then guide me through my first useful action.","steps":[],"skill":null},{"text":"Help me capture a new memory in Yaps. Ask what I want to remember and where it belongs.","steps":[],"skill":"Yaps memory"},{"text":"Summarize my five most recently updated Yaps notes and cite each note's title and path.","steps":[],"skill":"Yaps memory"}],"tools":[],"prefix":"","server":null,"instructions":[],"skills":[{"name":"yaps-memory","label":"Yaps memory","gist":"Use the user's private local Markdown Yaps vault as a durable memory store across AI tasks.","source":null,"raw":"$26"}],"skillNote":"1 in the ChatGPT listing"}],null]}],"$L27"]}]]}]] 22:o90b,1b:[["$","title","0",{"children":"Yaps Memory by Yaps AI: AI connector · Agent Ready"}],["$","meta","1",{"name":"description","content":"Private memory across chats. Available in ChatGPT."}],["$","link","2",{"rel":"manifest","href":"/manifest.webmanifest","crossOrigin":"$undefined"}],["$","link","3",{"rel":"canonical","href":"https://agentready.co/connectors/yaps-memory-2"}],["$","meta","4",{"property":"og:title","content":"Yaps Memory by Yaps AI: AI connector"}],["$","meta","5",{"property":"og:description","content":"Private memory across chats. Available in ChatGPT."}],["$","meta","6",{"property":"og:url","content":"https://agentready.co/connectors/yaps-memory-2"}],["$","meta","7",{"property":"og:site_name","content":"Agent Ready"}],["$","meta","8",{"property":"og:image","content":"https://agentready.co/connectors/yaps-memory-2/opengraph-image?3b61e23efdbb5225"}],["$","meta","9",{"property":"og:image:type","content":"image/png"}],["$","meta","10",{"property":"og:image:width","content":"1200"}],["$","meta","11",{"property":"og:image:height","content":"630"}],["$","meta","12",{"property":"og:image:alt","content":"AI connector on Agent Ready"}],["$","meta","13",{"property":"og:type","content":"website"}],["$","meta","14",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","15",{"name":"twitter:title","content":"Yaps Memory by Yaps AI: AI connector"}],["$","meta","16",{"name":"twitter:description","content":"Private memory across chats. Available in ChatGPT."}],["$","meta","17",{"name":"twitter:image","content":"https://agentready.co/connectors/yaps-memory-2/opengraph-image?3b61e23efdbb5225"}],["$","meta","18",{"name":"twitter:image:alt","content":"AI connector on Agent Ready"}],["$","meta","19",{"name":"twitter:image:type","content":"image/png"}],["$","meta","20",{"name":"twitter:image:width","content":"1200"}],["$","meta","21",{"name":"twitter:image:height","content":"630"}],["$","link","22",{"rel":"icon","href":"/favicon.ico?favicon.3iymezf4ycw3e.ico","sizes":"64x64","type":"image/x-icon"}],["$","link","23",{"rel":"icon","href":"/icon.svg?icon.1m07wgr9jqhm5.svg","sizes":"any","type":"image/svg+xml"}],["$","link","24",{"rel":"apple-touch-icon","href":"/apple-icon.png?apple-icon.3q8qrgufoflqu.png","sizes":"180x180","type":"image/png"}],["$","$L28","25",{}]] 22:o10,1c:null 22:null 22:o23,:HL["/stores/chatgpt.png","image"] 22:o129a,27:["$","aside",null,{"className":"side","children":[["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Stores"}],["$","div",null,{"className":"st","children":[["$","div","chatgpt",{"style":{"display":"contents"},"children":[["$","span",null,{"className":"s","children":[["$","img",null,{"className":"sm","src":"/stores/chatgpt.png","alt":"","width":16,"height":16}],["$","a",null,{"href":"https://chatgpt.com/plugins/plugins_6a56c4d8a4d08191b1ecb4a676bc1315?open_in_app","target":"_blank","rel":"noopener nofollow","children":[["$","b",null,{"children":"ChatGPT"}]," ↗"]}],null]}],["$","span",null,{"className":"rk2","children":[["#","4,607"," ",["$","small",null,{"children":["of ","9,245"]}]],null]}]]}]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Details"}],["$","dl",null,{"className":"kv","children":[[["$","dt",null,{"children":"Company"}],["$","dd",null,{"children":"Yaps AI"}]],[["$","dt",null,{"children":"Publisher"}],["$","dd",null,{"children":"Community"}]],["$","dt",null,{"children":"Category"}],["$","dd",null,{"children":["$","$L5",null,{"href":"/categories/ai-tools","children":"AI assistant add-ons"}]}],[["$","dt",null,{"children":"Audience"}],["$","dd",null,{"children":"For consumers"}]],null,["$","dt",null,{"children":"Sign-in"}],["$","dd",null,{"children":"None needed"}],["$","dt",null,{"children":"Interactive UI"}],["$","dd",null,{"children":"No"}],[["$","dt",null,{"children":"Checked"}],["$","dd",null,{"children":"Oct 27, 2026"}]],[["$","dt",null,{"children":"Website"}],["$","dd",null,{"children":["$","a",null,{"href":"https://yaps.ai","target":"_blank","rel":"noopener nofollow","children":"yaps.ai"}]}]]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":["More in ","AI assistant add-ons"]}],["$","ul",null,{"className":"sim","children":[["$","li","14965",{"children":["$","$L5",null,{"href":"/connectors/rhythm-ai-personality-tuner","prefetch":false,"children":[["$","$L23",null,{"name":"Rhythm AI Personality Tuner","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/02/02846ae172d38bae727fc11c13349772f8d2840b740c604ba8c165bdd8d844a9-64.webp","size":24}],["$","b",null,{"children":"Rhythm AI Personality Tuner"}],["$","small",null,{"children":"#146"}]]}]}],["$","li","4302",{"children":["$","$L5",null,{"href":"/connectors/playmcp","prefetch":false,"children":[["$","$L23",null,{"name":"PlayMCP","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/7e/7e9da62ddba915cd96ea88590aa0dd924d416591cf546e27a8d6cb3fe821608b-64.webp","size":24}],["$","b",null,{"children":"PlayMCP"}],["$","small",null,{"children":"#152"}]]}]}],["$","li","15060",{"children":["$","$L5",null,{"href":"/connectors/prompt-perfect","prefetch":false,"children":[["$","$L23",null,{"name":"Prompt Perfect","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/25/25c8b7a6dc543f28b9684227604bf15cec842945f4ac99b7c7fc130d321a8a39-64.webp","size":24}],["$","b",null,{"children":"Prompt Perfect"}],["$","small",null,{"children":"#333"}]]}]}],["$","li","15246",{"children":["$","$L5",null,{"href":"/connectors/basic-memory-cloud","prefetch":false,"children":[["$","$L23",null,{"name":"Basic Memory Cloud","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/48/48765542121cf50a22435c94e535acdf031b1b4208770d51e61a2e1e619acc59-64.webp","size":24}],["$","b",null,{"children":"Basic Memory Cloud"}],["$","small",null,{"children":"#1,199"}]]}]}],["$","li","15582",{"children":["$","$L5",null,{"href":"/connectors/tasknotify","prefetch":false,"children":[["$","$L23",null,{"name":"TaskNotify","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/cc/ccef65bdab248018fd966ac128ac1efec782e1b012f181200f01cb5d4b04753a-64.webp","size":24}],["$","b",null,{"children":"TaskNotify"}],["$","small",null,{"children":"#476"}]]}]}],["$","li","15388",{"children":["$","$L5",null,{"href":"/connectors/app-atlas","prefetch":false,"children":[["$","$L23",null,{"name":"App Atlas","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/8f/8fce6de54fe02b96dd3c7c81562f4faa5a36c4b92a47080da489b59a10709b46-64.webp","size":24}],["$","b",null,{"children":"App Atlas"}],["$","small",null,{"children":"#560"}]]}]}],["$","li","15337",{"children":["$","$L5",null,{"href":"/connectors/caveman-mode","prefetch":false,"children":[["$","$L23",null,{"name":"Caveman Mode","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/27/27efe08ae01ebda82f25893226e33a2c9c3d49b6c6ec787b9a0bff471a580795-64.webp","size":24}],"$L29","$L2a"]}]}],"$L2b"]}]]}]]}] 22:o1ea,29:["$","b",null,{"children":"Caveman Mode"}] 2a:["$","small",null,{"children":"#604"}] 2b:["$","li","15406",{"children":["$","$L5",null,{"href":"/connectors/engram-2","prefetch":false,"children":[["$","$L23",null,{"name":"Engram","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/37/37541cf9765efdad0155df1c3af9d933e5cd8be560b306e7281d804c9b56b28a-64.webp","size":24}],["$","b",null,{"children":"Engram"}],["$","small",null,{"children":"#650"}]]}]}] 22:o11,20:false 1f:7033 22:o17,1e:C 1d:C 1:C 15:C b:C 22:C </article></body></html>

22:o1,#22:o649,2:"$Sreact.fragment" 3:"/_next/static/immutable/chunks/12yk9g49l7-7r.js" 4:"/_next/static/immutable/chunks/2jrhxdtf12-uf.js" 5:I[7575,["$3","$4"],""] 6:I[10291,["$3"],"default"] 7:I[2968,["$3"],"default"] 8:I[4098,["$3"],"WebMCP"] 9:I[57507,["$3"],"ExternalLinks"] a:I[93137,["$3"],"Analytics"] 10:"$Sreact.suspense" 16:"ViewportBoundary" 17:I[82520,["$3"],"$16"] 19:"MetadataBoundary" 1a:I[82520,["$3"],"$19"] :HL["/_next/static/immutable/chunks/3g2_9hnyt6p64.css","style"] 1:X b:X d:X 15:X f:[["children",{"s":"__PAGE__","h":49314,"d":{"r":["$","$2","c",{"children":[["$","$10",null,{"fallback":["$","div",null,{"className":"wrap","style":{"minHeight":"60vh"}}],"children":"$L11"}],["$L12","$L13"],"$L14"]}],"p":false,"v":"$15"}}]] e:[["children",{"s":{"n":"slug","t":"d","k":"yaps-memory-2","s":[]},"h":49250,"d":{"r":["$","$2","c",{"children":[null,["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],"p":false,"v":"$d"},"c":"$Qf"}]] c:[["children",{"s":"connectors","h":49250,"d":{"r":["$","$2","c",{"children":[null,["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],"p":false,"v":"$d"},"c":"$Qe"}]] 1d:X 1e:X 22:o1232,0:{"q":"","i":false,"S":true,"r":"$1","t":{"t":{"s":"","h":49234,"d":{"r":["$","$2","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/3g2_9hnyt6p64.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/immutable/chunks/12yk9g49l7-7r.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"en","className":"ec5Qua_variable","children":["$","body",null,{"children":[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://agentready.co/#org\",\"name\":\"Agent Ready\",\"url\":\"https://agentready.co/\",\"logo\":\"https://agentready.co/icon-512.png\"},{\"@type\":\"WebSite\",\"@id\":\"https://agentready.co/#site\",\"name\":\"Agent Ready\",\"url\":\"https://agentready.co/\",\"publisher\":{\"@id\":\"https://agentready.co/#org\"}}]}"}}],["$","header",null,{"className":"site","children":["$","div",null,{"className":"wrap","children":[["$","$L5",null,{"href":"/","className":"brand","children":[["$","svg",null,{"className":"brand-mark","viewBox":"0 0 64 64","aria-hidden":"true","children":[["$","defs",null,{"children":["$","linearGradient",null,{"id":"arg","x1":"0","y1":"1","x2":"1","y2":"0","children":[["$","stop",null,{"offset":"0","stopColor":"#2563EB"}],["$","stop",null,{"offset":"1","stopColor":"#06B6D4"}]]}]}],["$","path",null,{"d":"M9 55 L32 9 L55 55","fill":"none","stroke":"url(#arg)","strokeWidth":"11","strokeLinecap":"round","strokeLinejoin":"round"}],["$","circle",null,{"cx":"32","cy":"45","r":"7","fill":"#FACC15"}]]}],"Agent Ready"]}],["$","nav",null,{"aria-label":"Main","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],["$","$L5",null,{"href":"/categories","className":"nv-x","children":"Categories"}],["$","$L5",null,{"href":"/blog","children":"Blog"}],["$","$L5",null,{"href":"/mcp-plugin-usage","className":"nv-x","children":"Usage"}],["$","$L5",null,{"href":"/methodology","className":"nv-x","children":"Methodology"}],["$","$L5",null,{"href":"/work-with-us","className":"nv-cta","children":"Work with us"}]]}]]}]}],["$","main",null,{"children":["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}],["$","$L8",null,{}],["$","$L9",null,{}],["$","$La",null,{}],["$","footer",null,{"className":"foot","children":["$","div",null,{"className":"wrap","children":[["$","span",null,{"children":"Agent Ready"}],["$","nav",null,{"aria-label":"Footer","children":[["$","$L5",null,{"href":"/blog","children":"Blog"}],["$","$L5",null,{"href":"/mcp-plugin-usage","children":"Usage"}],["$","$L5",null,{"href":"/methodology","children":"Methodology"}],["$","$L5",null,{"href":"/categories","children":"Categories"}],["$","a",null,{"href":"/llms.txt","children":"llms.txt"}],["$","a",null,{"href":"/sitemap.xml","children":"Sitemap"}],["$","$L5",null,{"href":"/work-with-us","children":"Work with us"}]]}]]}]}]]}]}]]}],"p":false,"v":"$b"},"c":"$Qc"},"h":{"r":["$","$2","h",{"children":[null,["$","$L17","y3tv2SdTfANN3GyuHXfq9v",{"children":"$L18"}],["$","$L1a","y3tv2SdTfANN3GyuHXfq9m",{"children":[["$","div",null,{"hidden":true,"children":["$","$10",null,{"name":"Next.Metadata","children":"$L1b"}]}],"$L1c"]}]]}],"p":false,"v":"$1d"}},"s":"$1e","a":"$@1f","w":"$@20"} 22:o1b1,21:I[82520,["$3"],"OutletBoundary"] :HL["/_next/static/immutable/chunks/2lo4itc7piqdu.css","style"] d:C 12:["$","link","0",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/2lo4itc7piqdu.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] 13:["$","script","script-0",{"src":"/_next/static/immutable/chunks/2jrhxdtf12-uf.js","async":true,"nonce":"$undefined"}] 14:["$","$L21",null,{"children":"$@22"}] 22:o14d,1e:300 18:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}],["$","meta","2",{"name":"theme-color","content":"#ffffff","media":"(prefers-color-scheme: light)"}],["$","meta","3",{"name":"theme-color","content":"#0d0d0f","media":"(prefers-color-scheme: dark)"}]] 22:o25,1d:0 15:0 15:T4,slug1d:T4,slug1e:300 22:o88,23:I[37521,["$3","$4"],"Logo"] 24:I[53913,["$3","$4"],"About"] 25:I[53913,["$3","$4"],"Explore"] 28:I[60329,["$3"],"IconMark"] 26:T2f7c,22:o2f7c,--- name: yaps-memory description: Use the user's private local Markdown Yaps vault as a durable memory store across AI tasks. Trigger for cross-task memory, remembered facts, personal knowledge, prior context, or requests to remember, capture, retrieve, search, cite, organize, update, tag, connect, or recover notes, ideas, dictation history, meeting notes, resources, and daily notes stored in Yaps. --- # Yaps Memory Use Yaps as a private, file-backed memory layer shared between the user and the current AI client. ## Choose the available transport Test capabilities instead of guessing the host from its product name or user agent: 1. Prefer Yaps MCP tools such as `vault_search` and `vault_note_get` when they are available. MCP enforces Yaps Agent Access and supplies the most structured interface. 2. If MCP is unavailable, try the skills-only CLI fallback with `vault status`. On macOS or Linux, locate `yaps-plugin-launcher.sh` at `/scripts/yaps-plugin-launcher.sh`; for a full local plugin checkout, fall back to `/scripts/yaps-plugin-launcher.sh`. This launcher can use Codex Desktop's bundled runtime on a clean computer where `node` is not installed globally. On Windows, locate the adjacent `yaps-plugin-launcher.cmd` instead; for a full local plugin checkout, fall back to `/scripts/yaps-plugin-launcher.cmd`. 3. Run the fallback on macOS or Linux as: ```text sh --action vault.status --stage reachability -- yaps --pretty vault status ``` In Windows PowerShell, run: ```text & "" --action vault.status --stage reachability -- yaps --pretty vault status ``` The runner honors an explicit override, checks `PATH`, then finds the CLI packaged inside the installed Yaps app, and validates it with a bounded, read-only `status` command. Never ask the user to install a CLI, edit PATH, copy a token, or configure MCP. 4. If either transport succeeds, continue with it for the task. Do not stop merely because MCP is absent; public uploaded plugins may intentionally be skills-only. 5. If the CLI validates but MCP is unavailable, say that the CLI is working and the private-vault connector is unavailable; continue through the CLI fallback when the task permits it. Never call that state “CLI missing.” If neither transport can reach Yaps, repeat the runner's specific recovery guidance. If the current task cannot reach the local engine, direct the user to a local-capable session on the computer where Yaps is installed: in Claude, that is Claude Code or the Claude desktop app; if the task is ChatGPT web, browser-only, or cloud-hosted, offer [ChatGPT desktop](https://chatgpt.com/download/) and a new local-capable Work or Codex task. Do not claim Yaps is uninstalled merely because it was not found in the known locations. When its recovery code is `cli_missing`, offer [Yaps desktop](https://yaps.ai/download) as the direct install-or-open step; do not describe it as a separate CLI download. The plugin, Yaps desktop installation, sign-in, and trial or Yaps Pro activation may happen in any order. Account or subscription changes do not require reinstalling or reconnecting the plugin. A new task is only needed when the current task began before the local Yaps capability became available. ## Private operational diagnostics Run every local Yaps CLI command through the platform launcher and runner. Use a stable content-free action and one of these stages: `reachability`, `authentication`, `readiness`, `execution`, or `export`. macOS/Linux examples: ```text sh --action vault.search --stage execution -- yaps --pretty vault search-semantic "" --limit 8 sh --action vault.get --stage execution -- yaps --pretty vault get "" ``` On Windows, use `& ""` in place of `sh `. If the launcher or runner is unavailable but the CLI itself is reachable, continue directly; diagnostics must never block the feature. Breadcrumbs may contain only plugin identity, detected host, action, stage, outcome, duration, and a fixed safe error category. They must never contain the user's prompt or conversation, arguments, output, credentials, paths, filenames, note text, or raw errors. Never create or guess an owner marker; Yaps supplies the opaque marker used by diagnostics. ## CLI discovery contract Use the bundled runner for every CLI fallback instead of searching for a binary or composing an application path yourself. It honors an explicit path or `YAPS_CLI_BINARY`, then checks `PATH`, then the verified Yaps app locations on macOS, Windows, and Linux. It validates candidates with `status`, never a shell, and never invokes the macOS GUI executable. The MCP launcher uses this same contract before resolving `yaps_mcp`, which is why it can distinguish a missing or invalid CLI from an unavailable private-vault connector. Both launchers follow the desktop app's recommended settings path automatically. When a signed-in account cache is temporarily incomplete, they safely wake the verified installed app and retry for a bounded time; do not ask the user to copy a path or reconnect the plugin. ## Transport mapping Use the MCP tool named on the left when present. In skills-only mode, use the equivalent CLI command on the right, adding `--pretty` globally when JSON needs to be inspected: ```text vault_status yaps vault status vault_notes_list yaps vault list [filters] vault_note_get yaps vault get vault_search yaps vault search [filters] vault_search_semantic yaps vault search-semantic [--limit N] [--mode hybrid] vault_note_create yaps vault create [--path P] [--title T] [--markdown-file F] vault_note_update yaps vault update --expected-updated-at N [fields] vault_note_move yaps vault move

vault_note_rename yaps vault rename

vault_note_delete yaps vault delete --confirm [--expected-title T] vault_open_daily_note yaps vault daily-open vault_create_from_template yaps vault create-from-template vault_note_history_list yaps vault history-list <path> vault_note_history_restore yaps vault history-restore <path> <snapshot-id> vault_note_pin yaps vault pin <path> [--set true|false] vault_folders_list yaps vault folders [--limit N] vault_tags_* yaps vault tags list|add|remove|replace|rename|delete vault_mentions_* yaps vault mentions list|terms vault_backlinks yaps vault backlinks <path> ``` Run `yaps vault <command> --help` before using an unfamiliar option. For substantial Markdown, write the proposed body to a temporary file and pass `--markdown-file`; do not risk shell quoting corruption. Remove temporary files after the command completes. ## Availability and permissions The vault is local Markdown and the AI client only receives content retrieved for the user's request. Do not bulk-read it. MCP connections start read-only. If MCP reports `Agent read denied by Yaps Agent Access policy`, give the exact path **Yaps → Settings → Agent Access** and ask the user to re-enable this client. Writes remain a separate opt-in; never change that policy yourself. The skills-only CLI fallback is governed by the AI host's local command permissions rather than MCP Agent Access. In that mode: - Read only what the current request requires. - Write only when the user explicitly asks to remember, create, update, organize, restore, move, rename, tag, pin, or delete something. - Never infer permission for a write from a general request to search, summarize, review, or onboard. - Treat delete, restore, move, rename, and vault-wide tag changes as destructive and require explicit intent. If Yaps reports no signed-in account or active entitlement, explain the exact missing step from that message and ask the user to complete it inside Yaps. Never request credentials or payment details, promise trial eligibility or duration, or offer a free-tier continuation. Safe automatic account status requires Yaps 2.3.124 or newer. On an older or unverifiable helper, repeat the runner's update guidance; do not run a direct `auth status`, approve a Keychain prompt, or invent a separate connection step. ## Onboarding When the user asks to set up or get started: 1. Resolve a working transport and run `vault_status` / `yaps vault status`. Do not read note contents during the connection check. 2. Explain briefly that the vault is local Markdown and retrieval is request-scoped. Explain the active permission model: Agent Access for MCP, or explicit-request-only writes for the skills-only CLI fallback. 3. If the vault is empty, say the connection works and offer exactly these choices: - Open Yaps desktop to create the first note; recommend this for voice capture and visual browsing. - Ask this AI client to capture the first memory. 4. Otherwise offer exactly these choices: - Review my five most recently updated notes. - Search my memory for a topic or question. - Capture something new. 5. After the chosen action, cite the note title and path and say clearly whether anything changed. ## Retrieval workflow 1. Search narrowly with semantic search when meaning matters, or lexical search for names, exact phrases, tags, and paths. 2. Retrieve only promising notes; do not bulk-read the vault when a focused query will do. 3. Distinguish vault evidence from inference. Cite each material vault claim using the returned note title and relative path. Say when evidence conflicts or may be stale. 4. Use backlinks, mentions, folders, or tags only when relationships materially help. ## Capture and safe edits - When the user says “remember this,” create or update a durable note rather than merely acknowledging it. - Prefer the daily note for journal-like capture and templates when the user identifies one. - Preserve the user's wording. Add only lightweight structure that improves retrieval. - Search by title and key phrase before creating a likely duplicate. - Read a note immediately before updating it. Pass its `updated_at` value as `expected_updated_at` so concurrent edits are never silently overwritten. - Make the smallest requested change and preserve unrelated content, frontmatter, links, and formatting. - If a stale-write guard fails, retrieve the new version, reconcile visibly, and ask when the merge is ambiguous. - For delete, include `--confirm` only after explicit intent and use `--expected-title` when available. ## Generalist Yaps mode Memory is the default focus, not a boundary around what it can do. When the user explicitly asks for another Yaps workflow, use the same resolved `yaps_cli` and follow its help. The full local surface includes settings, auth, feature setup, speech/TTS, subtitles, meetings, captions, media conversion, audio cleaning, translation, history, and local usage. Do not broaden into these workflows without a request. ```text status settings list|get|set|unset auth status|usage|billing features list|dictation|cleanup|reading|subtitles|auto-captions vault status|list|get|create|update|move|rename|delete|search|search-semantic|daily-open|create-from-template|history-list|history-restore|pin|folders|tags|mentions|backlinks speech synthesize (alias: tts) srt generate meeting transcribe|show|correct|assign|rename-speaker|export captions styles|create|show|correct|replace|split|merge|style|reset|render|verify media extract-audio|remove-background|generate-image audio clean translate history-list usage-local ``` ## Friendly completion and discovery Lead with the outcome, cite the affected note title and path, and state whether anything changed. Do not dump raw JSON or internal tool names. After a successful task, a compact **More with Yaps** section may offer up to three relevant next actions. Skip it after a failure, a decline, or a request for a terse result. 22:oacc,11:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@type\":\"SoftwareApplication\",\"name\":\"Yaps Memory\",\"description\":\"Private memory across chats\",\"applicationCategory\":\"AI assistant add-ons\",\"operatingSystem\":\"ChatGPT\",\"url\":\"https://agentready.co/connectors/yaps-memory-2\",\"sameAs\":[\"https://chatgpt.com/plugins/plugins_6a56c4d8a4d08191b1ecb4a676bc1315?open_in_app\"],\"image\":\"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/d6/d693f4e16e2a73d7f8765d97642fa8f01c2fbb8e29bb383fcf1ecd797afb0b18-64.webp\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Yaps AI\",\"url\":\"https://yaps.ai\"}}"}}],["$","div",null,{"className":"wrap","children":[["$","div",null,{"className":"pp-head","children":[["$","$L23",null,{"name":"Yaps Memory","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/d6/d693f4e16e2a73d7f8765d97642fa8f01c2fbb8e29bb383fcf1ecd797afb0b18-64.webp","size":56}],["$","div",null,{"children":[["$","div",null,{"className":"crumbs","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],[" / ",["$","$L5",null,{"href":"/categories/ai-tools","children":"AI assistant add-ons"}]]]}],["$","h1",null,{"children":["Yaps Memory",null]}]]}]]}],["$","div",null,{"className":"pp","children":[["$","div",null,{"className":"ca","children":[["$","p",null,{"className":"tag","children":"Private memory across chats"}],["$","$L24",null,{"text":"Remember facts across Codex chats, recall prior project context, search and cite private Markdown notes, and safely update a user-owned vault. The plugin, Yaps desktop setup, and trial or Yaps Pro activation can be completed in any order; the private local connection reconciles automatically. Requires a local-capable your AI Desktop Work or Codex session; your AI web and cloud sessions cannot reach the installed Yaps engine. Users can also use the vault directly in Yaps."}],["$","$L25",null,{"examples":[{"text":"Set up Yaps Memory. Check my connection, explain privacy and permissions, then guide me through my first useful action.","steps":[],"skill":null},{"text":"Help me capture a new memory in Yaps. Ask what I want to remember and where it belongs.","steps":[],"skill":"Yaps memory"},{"text":"Summarize my five most recently updated Yaps notes and cite each note's title and path.","steps":[],"skill":"Yaps memory"}],"tools":[],"prefix":"","server":null,"instructions":[],"skills":[{"name":"yaps-memory","label":"Yaps memory","gist":"Use the user's private local Markdown Yaps vault as a durable memory store across AI tasks.","source":null,"raw":"$26"}],"skillNote":"1 in the ChatGPT listing"}],null]}],"$L27"]}]]}]] 22:o90b,1b:[["$","title","0",{"children":"Yaps Memory by Yaps AI: AI connector · Agent Ready"}],["$","meta","1",{"name":"description","content":"Private memory across chats. Available in ChatGPT."}],["$","link","2",{"rel":"manifest","href":"/manifest.webmanifest","crossOrigin":"$undefined"}],["$","link","3",{"rel":"canonical","href":"https://agentready.co/connectors/yaps-memory-2"}],["$","meta","4",{"property":"og:title","content":"Yaps Memory by Yaps AI: AI connector"}],["$","meta","5",{"property":"og:description","content":"Private memory across chats. Available in ChatGPT."}],["$","meta","6",{"property":"og:url","content":"https://agentready.co/connectors/yaps-memory-2"}],["$","meta","7",{"property":"og:site_name","content":"Agent Ready"}],["$","meta","8",{"property":"og:image","content":"https://agentready.co/connectors/yaps-memory-2/opengraph-image?3b61e23efdbb5225"}],["$","meta","9",{"property":"og:image:type","content":"image/png"}],["$","meta","10",{"property":"og:image:width","content":"1200"}],["$","meta","11",{"property":"og:image:height","content":"630"}],["$","meta","12",{"property":"og:image:alt","content":"AI connector on Agent Ready"}],["$","meta","13",{"property":"og:type","content":"website"}],["$","meta","14",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","15",{"name":"twitter:title","content":"Yaps Memory by Yaps AI: AI connector"}],["$","meta","16",{"name":"twitter:description","content":"Private memory across chats. Available in ChatGPT."}],["$","meta","17",{"name":"twitter:image","content":"https://agentready.co/connectors/yaps-memory-2/opengraph-image?3b61e23efdbb5225"}],["$","meta","18",{"name":"twitter:image:alt","content":"AI connector on Agent Ready"}],["$","meta","19",{"name":"twitter:image:type","content":"image/png"}],["$","meta","20",{"name":"twitter:image:width","content":"1200"}],["$","meta","21",{"name":"twitter:image:height","content":"630"}],["$","link","22",{"rel":"icon","href":"/favicon.ico?favicon.3iymezf4ycw3e.ico","sizes":"64x64","type":"image/x-icon"}],["$","link","23",{"rel":"icon","href":"/icon.svg?icon.1m07wgr9jqhm5.svg","sizes":"any","type":"image/svg+xml"}],["$","link","24",{"rel":"apple-touch-icon","href":"/apple-icon.png?apple-icon.3q8qrgufoflqu.png","sizes":"180x180","type":"image/png"}],["$","$L28","25",{}]] 22:o10,1c:null 22:null 22:o23,:HL["/stores/chatgpt.png","image"] 22:o129a,27:["$","aside",null,{"className":"side","children":[["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Stores"}],["$","div",null,{"className":"st","children":[["$","div","chatgpt",{"style":{"display":"contents"},"children":[["$","span",null,{"className":"s","children":[["$","img",null,{"className":"sm","src":"/stores/chatgpt.png","alt":"","width":16,"height":16}],["$","a",null,{"href":"https://chatgpt.com/plugins/plugins_6a56c4d8a4d08191b1ecb4a676bc1315?open_in_app","target":"_blank","rel":"noopener nofollow","children":[["$","b",null,{"children":"ChatGPT"}]," ↗"]}],null]}],["$","span",null,{"className":"rk2","children":[["#","4,607"," ",["$","small",null,{"children":["of ","9,245"]}]],null]}]]}]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Details"}],["$","dl",null,{"className":"kv","children":[[["$","dt",null,{"children":"Company"}],["$","dd",null,{"children":"Yaps AI"}]],[["$","dt",null,{"children":"Publisher"}],["$","dd",null,{"children":"Community"}]],["$","dt",null,{"children":"Category"}],["$","dd",null,{"children":["$","$L5",null,{"href":"/categories/ai-tools","children":"AI assistant add-ons"}]}],[["$","dt",null,{"children":"Audience"}],["$","dd",null,{"children":"For consumers"}]],null,["$","dt",null,{"children":"Sign-in"}],["$","dd",null,{"children":"None needed"}],["$","dt",null,{"children":"Interactive UI"}],["$","dd",null,{"children":"No"}],[["$","dt",null,{"children":"Checked"}],["$","dd",null,{"children":"Oct 27, 2026"}]],[["$","dt",null,{"children":"Website"}],["$","dd",null,{"children":["$","a",null,{"href":"https://yaps.ai","target":"_blank","rel":"noopener nofollow","children":"yaps.ai"}]}]]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":["More in ","AI assistant add-ons"]}],["$","ul",null,{"className":"sim","children":[["$","li","14965",{"children":["$","$L5",null,{"href":"/connectors/rhythm-ai-personality-tuner","prefetch":false,"children":[["$","$L23",null,{"name":"Rhythm AI Personality Tuner","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/02/02846ae172d38bae727fc11c13349772f8d2840b740c604ba8c165bdd8d844a9-64.webp","size":24}],["$","b",null,{"children":"Rhythm AI Personality Tuner"}],["$","small",null,{"children":"#146"}]]}]}],["$","li","4302",{"children":["$","$L5",null,{"href":"/connectors/playmcp","prefetch":false,"children":[["$","$L23",null,{"name":"PlayMCP","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/7e/7e9da62ddba915cd96ea88590aa0dd924d416591cf546e27a8d6cb3fe821608b-64.webp","size":24}],["$","b",null,{"children":"PlayMCP"}],["$","small",null,{"children":"#152"}]]}]}],["$","li","15060",{"children":["$","$L5",null,{"href":"/connectors/prompt-perfect","prefetch":false,"children":[["$","$L23",null,{"name":"Prompt Perfect","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/25/25c8b7a6dc543f28b9684227604bf15cec842945f4ac99b7c7fc130d321a8a39-64.webp","size":24}],["$","b",null,{"children":"Prompt Perfect"}],["$","small",null,{"children":"#333"}]]}]}],["$","li","15246",{"children":["$","$L5",null,{"href":"/connectors/basic-memory-cloud","prefetch":false,"children":[["$","$L23",null,{"name":"Basic Memory Cloud","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/48/48765542121cf50a22435c94e535acdf031b1b4208770d51e61a2e1e619acc59-64.webp","size":24}],["$","b",null,{"children":"Basic Memory Cloud"}],["$","small",null,{"children":"#1,199"}]]}]}],["$","li","15582",{"children":["$","$L5",null,{"href":"/connectors/tasknotify","prefetch":false,"children":[["$","$L23",null,{"name":"TaskNotify","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/cc/ccef65bdab248018fd966ac128ac1efec782e1b012f181200f01cb5d4b04753a-64.webp","size":24}],["$","b",null,{"children":"TaskNotify"}],["$","small",null,{"children":"#476"}]]}]}],["$","li","15388",{"children":["$","$L5",null,{"href":"/connectors/app-atlas","prefetch":false,"children":[["$","$L23",null,{"name":"App Atlas","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/8f/8fce6de54fe02b96dd3c7c81562f4faa5a36c4b92a47080da489b59a10709b46-64.webp","size":24}],["$","b",null,{"children":"App Atlas"}],["$","small",null,{"children":"#560"}]]}]}],["$","li","15337",{"children":["$","$L5",null,{"href":"/connectors/caveman-mode","prefetch":false,"children":[["$","$L23",null,{"name":"Caveman Mode","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/27/27efe08ae01ebda82f25893226e33a2c9c3d49b6c6ec787b9a0bff471a580795-64.webp","size":24}],"$L29","$L2a"]}]}],"$L2b"]}]]}]]}] 22:o1ea,29:["$","b",null,{"children":"Caveman Mode"}] 2a:["$","small",null,{"children":"#604"}] 2b:["$","li","15406",{"children":["$","$L5",null,{"href":"/connectors/engram-2","prefetch":false,"children":[["$","$L23",null,{"name":"Engram","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/37/37541cf9765efdad0155df1c3af9d933e5cd8be560b306e7281d804c9b56b28a-64.webp","size":24}],["$","b",null,{"children":"Engram"}],["$","small",null,{"children":"#650"}]]}]}] 22:o11,20:false 1f:7033 22:o17,1e:C 1d:C 1:C 15:C b:C 22:C </article></body></html>

Yaps Memory

What you can ask

Skills

Yaps Memory

What you can ask

Skills