ai memory.md
AI Memory
An assistant that saves what it learns about you into a memory list. New facts replace the ones they contradict, and you can edit or forget any of them.
Source: https://kokonutui.com/docs/ai/ai-memory
Installation
npx shadcn@latest add @kokonutui/ai-memory
Props
| Prop | Type | Default | Description |
|---|---|---|---|
title? |
string |
"Assistant" |
|
greeting? |
string |
"Hi Samantha. What's new? Tell me anything and … |
What the assistant opens with. |
initialMemories? |
MemoryItem[] |
demo |
Your saved memories, read once on mount. |
suggestions? |
string[] |
Object.keys(DEMO_REPLIES) |
Messages offered as one-tap replies. |
remember? |
(text: string, memories: MemoryItem[]) => MemoryChange | Promise<MemoryChange> |
demo |
Answers a message and decides what to remember, from the memories in the panel. Return the change or a Promise of it; the assistant shows it thinking until it resolves. Throw and the reply shows the error's message. Demo when omitted. |
onSave? |
(memory: MemoryItem, replaced?: MemoryItem) => void |
A memory was saved. With replaced, it took that one's place. |
|
onEdit? |
(memory: MemoryItem) => void |
A memory was edited by hand. | |
onForget? |
(memory: MemoryItem) => void |
A memory was forgotten, once its Undo has passed. | |
className? |
string |
Extra classes for the root element. |
MemoryItem
| Field | Type | Description |
|---|---|---|
id |
string |
|
text |
string |
|
group |
string |
|
saved |
string |
When it was saved, in words, e.g. "Today" or "Sep 12". |
MemoryChange
| Field | Type | Description |
|---|---|---|
reply |
string |
|
memory? |
{ text: string; group: string; replaces?: string } |
A fact to save. With replaces, it takes the place of an older one. |
Usage
Pass your saved memories as initialMemories and a remember that asks your model. It gets the message and the memories in the panel, and returns the reply plus, when there's something worth keeping, a memory to save (with replaces set to an older memory's id to update it). Return it as a Promise and the assistant shows it thinking until it resolves; throw and the reply shows the error's message. onSave, onEdit and onForget tell you what to persist; a forget only fires once its Undo has passed.
"use client";
import AIMemory, { type MemoryChange, type MemoryItem } from "@/components/kokonutui/ai-memory";
export function Assistant({ memories }: { memories: MemoryItem[] }) {
return (
<AIMemory
greeting="Hi. What's new?"
initialMemories={memories}
onEdit={(memory) => fetch(`/api/memories/${memory.id}`, { method: "PUT", body: JSON.stringify(memory) })}
onForget={(memory) => fetch(`/api/memories/${memory.id}`, { method: "DELETE" })}
onSave={(memory, replaced) =>
fetch("/api/memories", { method: "POST", body: JSON.stringify({ memory, replaces: replaced?.id }) })
}
remember={async (text, memories) => {
const res = await fetch("/api/remember", {
method: "POST",
body: JSON.stringify({ text, memories }),
});
if (!res.ok) {
throw new Error("Couldn't reach the model. Nothing was saved.");
}
return (await res.json()) as MemoryChange;
}}
suggestions={[]}
/>
);
}
// app/api/remember/route.ts
import { anthropic } from "@ai-sdk/anthropic";
import { generateObject } from "ai";
import { z } from "zod";
export async function POST(req: Request) {
const { text, memories } = await req.json();
const { object } = await generateObject({
model: anthropic("claude-sonnet-5-5"),
schema: z.object({
reply: z.string(),
memory: z
.object({ text: z.string(), group: z.string(), replaces: z.string().optional() })
.optional(),
}),
system: `Reply briefly. Save a memory only for lasting facts about the user. Known: ${JSON.stringify(memories)}`,
prompt: text,
});
return Response.json(object);
}
<Demo(mdx/demos/ai-memory-stream) />