Smara Memory Skill#

Gives your agent persistent memory across conversations. Store facts about users, search by meaning, and retrieve full context — powered by Smara's Ebbinghaus decay scoring.

When to use#

• When the agent learns something about a user that should persist (preferences, facts, context)
• When the agent needs to recall what it knows about a user
• When the agent should check if it already knows something before asking again
• After meaningful conversations to extract and store key facts

Setup#

1. Get a free API key at https://smara.io
2. Set SMARA_API_KEY in your environment

Actions#

Store a memory#

bash

curl -X POST https://api.smara.io/v1/memories \
  -H "Authorization: Bearer $SMARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_id_here",
    "fact": "User prefers dark mode and uses vim keybindings",
    "importance": 0.7
  }'

Search memories#

bash

curl "https://api.smara.io/v1/memories/search?user_id=user_id_here&query=editor+preferences&limit=5" \
  -H "Authorization: Bearer $SMARA_API_KEY"

Get full user context#

bash

curl "https://api.smara.io/v1/users/user_id_here/context" \
  -H "Authorization: Bearer $SMARA_API_KEY"

Delete a memory#

bash

curl -X DELETE "https://api.smara.io/v1/memories/MEMORY_ID" \
  -H "Authorization: Bearer $SMARA_API_KEY"

Instructions for the agent#

1. After conversations: Extract key facts (preferences, decisions, context) and store them as memories with relevant tags
2. Before responding: Search for relevant memories to personalize responses
3. Contradiction handling: Smara automatically handles contradictions — if a user changes a preference, just store the new one and the old one is soft-deleted
4. Duplicate handling: Smara skips duplicates automatically — safe to store the same fact multiple times
5. Decay scoring: Memories naturally lose weight over time. Recent, frequently-accessed memories rank higher. This is automatic.

Example workflow#

text

User: "I switched to Neovim last week"

Agent thinks:
1. Search memories for "editor preferences" → finds "Uses vim keybindings"
2. Store new memory: "Switched to Neovim (from vim)" with tags ["preferences", "editor"]
3. Smara auto-detects contradiction with old vim memory → soft-deletes it
4. Respond acknowledging the switch

API Reference#

Full docs: https://api.smara.io/docs/