Human Memory Tool

What is it?

The Human Memory Tool is Yukkai's built-in system for remembering who you are. It stores durable facts about you — your name, language preferences, work habits, recurring patterns, and project context — so that Yukkai can personalize its assistance across conversations without you having to repeat yourself.

Unlike one-off notes or task details, the Human Memory Tool focuses on long-lasting, reusable knowledge about you as a person. It is distinct from other knowledge systems in Yukkai:

• RAG stores searchable documents and code files.
• User Rules store standing directives ("always write in English," "never use tabs").
• Human Memory stores learned facts about you as an individual.

How it works

Every fact stored in Human Memory belongs to one of five layers:

Layer	What it holds	Example
identity	Core facts about who you are	Name, location, profession
preferences	Things you like or dislike	Preferred language, code style
patterns	Recurring behaviors	"Always reviews PRs in the morning"
episodic	Notable past events	"Launched a startup in March 2024"
projects	Active project context	"Building an iOS app in SwiftUI"

Each fact also carries a source and a confidence score (0.0–1.0) so Yukkai can tell how reliable a piece of information is:

• stated — You explicitly said it (highest trust).
• observed — Yukkai noticed it from your behavior.
• inferred — Yukkai deduced it from context (lowest trust).

How to use it

You don't need to do anything special — Yukkai automatically consults your memory at the start of every session. However, you can interact with it directly in several ways:

1. Tell Yukkai about yourself

Just mention things in conversation:

"I'm based in Paris and I prefer responses in English."

Yukkai will store this as a fact and recall it in future sessions.

2. Ask what Yukkai knows about you

Ask at any time:

"What do you know about me?"

Yukkai will pull a snapshot of all stored facts across every layer.

3. Correct outdated information

If Yukkai remembers something wrong, just correct it:

"Actually, I switched to using VS Code, not Xcode."

Yukkai will update the stored fact accordingly.

Examples

Checking your memory profile

You: What do you remember about me?

Yukkai: Here's what I know about you:
  • Identity: Based in Paris, software developer
  • Preferences: Prefers English responses, uses Swift and SwiftUI
  • Patterns: Tends to work late evenings, reviews code standing up
  • Projects: Currently building a health-tracking iOS app

Adding a fact explicitly

You: Remember that my favorite code editor is Zed.

Yukkai: Got it! I've saved that you prefer Zed as your code editor.

Clearing or correcting facts

You: I don't use Xcode anymore, I switched to Cursor.

Yukkai: Updated! I now remember you prefer Cursor over Xcode.

Tips & best practices

• Be explicit for important facts. Say "I prefer..." or "My name is..." so Yukkai stores it with high confidence as a stated fact rather than guessing.
• Correct mistakes early. If Yukkai assumes something wrong about you, correct it right away so outdated facts don't persist.
• Use it for durable info only. One-off task details (like "fix the login bug today") belong in tasks, not in memory. Memory is for things that stay true over time.
• Review periodically. Ask Yukkai what it knows about you every now and then to make sure the stored facts are still accurate.
• Layer awareness matters. If you want Yukkai to remember something specific about a project, mention the project context so it lands in the right layer.