Memories

Memories are the foundation of Kyew. When you tell your AI to remember something, it's saved permanently and available in every future conversation — across all your AI apps and devices.

What is a Memory?

A memory is something you've told your AI to remember, stored with context so it can be found later. Each memory has:

• Observation — the core information ("Sarah's email is [email protected]")
• Domain — what area it relates to ("client-reporting", "team-processes", "personal")
• Category — what kind of information ("preference", "process", "contact")
• Outcome — whether something worked or not
• Tags — optional labels for filtering

Your AI fills in these details automatically based on your conversation — you just say "remember that..." and it handles the rest.

The memory Tool

All memory operations use the memory tool with an action parameter.

Storing Memories

Just tell your AI to remember something:

"remember that weekly reports go to [email protected] every Friday"

Behind the scenes, your AI calls:

memory(action="learn", observation="Weekly reports go to [email protected] every Friday", domain="client-reporting")

Optional parameters for richer context:

memory(action="learn",
  observation="We use the blue brand template for all client decks",
  domain="client-reporting",
  task_type="reporting",
  tools_used=["google-slides"],
  outcome="success",
  tags=["templates", "branding"])

Recalling Memories

Ask your AI to recall what it knows:

"what do you remember about my reporting workflow?"

This calls:

memory(action="recall", query="reporting workflow", domain="client-reporting")

Additional options:

• include — what to search: "memories", "skills", or "all" (default: "all")
• limit — maximum results to return
• format — "detailed" or "compact"
• summarize — true to get an AI-generated summary instead of raw results

memory(action="recall", query="client reporting", domain="client-reporting", include="memories", limit=5, format="detailed")

Correcting Memories

If a memory has an error, just tell your AI:

"correct that memory — Sarah's email is actually [email protected]"

This calls:

memory(action="correct", memory_id="mem_abc123", correction="Sarah's email is [email protected]")

The old version is kept for history with full lineage, and a corrected version replaces it.

Forgetting Memories

If a memory is outdated:

"forget the memory about our old standup schedule"

This calls:

memory(action="forget", memory_id="mem_abc123")

The memory won't appear in searches anymore, but it's kept in your history for reference. You can optionally link to a replacement:

memory(action="forget", memory_id="mem_abc123", superseded_by="mem_def456")

Memory Best Practices

Be Specific

Specific memories are more useful than vague ones:

# Good
"remember that reports go to Sarah on Fridays"

# Better
"remember that weekly client reports go to [email protected] every Friday
by 5pm, using the blue brand template with data from Linear"

Include Context

Context helps your AI find the right memories later:

# Minimal context
"remember that meetings are on Tuesdays"

# Rich context
"remember in the team-processes topic that our team standup is every
Tuesday at 9am on Zoom, and notes go in the #standup Slack channel"

Use Consistent Domains

Group related memories under the same domain name:

# Consistent — Kyew finds patterns easily
domain: "client-reporting"
domain: "client-reporting"
domain: "client-reporting"

# Inconsistent — harder to connect the dots
domain: "reports"
domain: "client-work"
domain: "reporting"

Record What Didn't Work Too

Knowing what failed is just as valuable:

"remember that sending the report as a PDF attachment didn't work —
Sarah prefers a direct link to the Google Doc"

How Memories Become Skills

Memories are the building blocks for skills — reusable workflows your AI can apply automatically:

1. Save memories around a domain
2. Kyew notices patterns (3+ related memories)
3. A skill is generated from those patterns
4. You approve it and your AI applies it going forward

The more specific and consistent your memories, the better the skills Kyew creates.

API Reference

For the full technical reference including all parameters and options, see memory Tool Reference.