Memory Skill

Persistent key-value storage for agent memory. Store important information and recall it later.

When to Use

✅ USE this skill when:

• "Remember that my favorite color is blue"

• "What did I tell you about my project?"

• "Forget my preferences"

• "What do you know about X?"

• Storing user preferences for later recall

• Saving context across conversations

When NOT to Use

❌ DON'T use this skill when:

• Temporary storage during a single session → use variables

• Large data storage → use file system

• Sensitive data → use secure storage

Storage Location

Memory is stored in ~/.agent-memory/memory.json as a JSON file.

Commands

Store Information

{baseDir}/memory.sh store "project_name" "My Cool Project" {baseDir}/memory.sh store "preferences" '{"theme": "dark", "language": "en"}' {baseDir}/memory.sh store --category "work" "company" "Acme Corp"

Recall Information

{baseDir}/memory.sh recall "project_name" {baseDir}/memory.sh recall --all {baseDir}/memory.sh recall --category "work" {baseDir}/memory.sh search "project"

Forget Information

{baseDir}/memory.sh forget "project_name" {baseDir}/memory.sh forget --category "work" {baseDir}/memory.sh forget --all

List Categories

{baseDir}/memory.sh categories {baseDir}/memory.sh stats

Categories

Organize memory by category:

• personal

• Personal preferences and info

• work

• Work-related information

• projects

• Project details

• context

• Conversation context

• Custom categories as needed

Examples

Store user preference:

{baseDir}/memory.sh store --category "personal" "timezone" "America/New_York"

Recall specific value:

{baseDir}/memory.sh recall "timezone"

Output: America/New_York

Search for related keys:

{baseDir}/memory.sh search "project"

Output: project_name, project_status, project_url

Get all memory for a category:

{baseDir}/memory.sh recall --category "work"

Output: {"company": "Acme Corp", "role": "Developer"}

Notes

• Memory persists across sessions in a JSON file

• Values can be simple strings or JSON objects

• Categories help organize related memories

• Use --all flag carefully (affects all stored data)