Memory Management Skill

alma

Commands

# List all memories
alma memory list

# Semantic search
alma memory search <query>

# Add a memory
alma memory add <content>

# Delete a memory
alma memory delete <id>

# View memory stats
alma memory stats

When to Use

• User asks anything about the past ("do you know what I like", "what did we discuss before", "what was that plan we talked about last time") → Search memories AND grep threads
• User says "remember this" →

  alma memory add "..."

• User asks "do you remember..." →

  alma memory search "..."

  +

  alma memory grep "..."

• User says "forget about..." → Search and delete matching memories
• Time-sensitive info (projects, deadlines) → Store with appropriate context

Search Strategy

1. alma memory search "<query>"

   — semantic search for related concepts

2. alma memory grep "<keyword>"

   — keyword search in conversation history

Conversation History Search

# Keyword search through all archived conversations
alma memory grep <keyword>

# Force re-archive all threads now
alma memory archive

threads/

Two-Layer Memory

1. Vector Memory (

   alma memory search

   ) — semantic search, finds conceptually related memories
2. Conversation Archives (

   alma memory grep

   ) — keyword search, finds exact words/phrases in past conversations

Group Chat History

# List all known groups
alma group list

# View recent history (default 50 messages)
alma group history <chatId> [limit]

# Search across all group chats
alma group search <keyword>

~/.config/alma/groups/<chatId>_<date>.log

People Profiles (Per-Person Memory)

# List all known people
alma people list

# View someone's profile
alma people show <name>

# Set/overwrite profile
alma people set <name> <content>

# Append to profile
alma people append <name> <fact>

# Delete profile
alma people delete <name>

• Someone shares personal info (job, hobbies, preferences)
• You learn their communication style or language preference
• They mention relationships with other people
• Any fact you'd want to remember next time you talk to them

~/.config/alma/people/<name>.md

Tips

• Always confirm what you stored/deleted with the user
• Use

  alma memory search

  to find related memories before adding duplicates
• Memories are automatically injected into conversations via semantic search — you don't need to manually recall them every time
• Use

  alma memory grep

  to search through conversation history when vector search doesn't find what you need
• For per-person facts, prefer

  alma people

  over

  alma memory

  — structured and won't get mixed up