SimpleMem Skill

Persistent conversational memory across sessions.

Proactive Usage

Save memories when discovering valuable dialogue:

• Important decisions or commitments made in conversation
• Complex information that may be referenced later
• Context from long discussions worth preserving
• Solutions to problems that took effort to uncover

Check memories before:

• Answering questions about past conversations
• Resuming work from previous sessions
• Building on earlier discussion topics

Quick Start

# Add a dialogue
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm"

# Query memories
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "When should Alice meet Bob?"

Operations

Save

Add single dialogue:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "User" --content "Your message here"

With timestamp (ISO 8601):

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Message" --timestamp "2026-01-17T14:00:00Z"

Query

Semantic query with answer:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "What did Alice say about meetings?"

With reflection for deeper analysis:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "Your question" --enable-reflection

Raw retrieval:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py retrieve --query "Alice meetings" --top-k 5

Maintain

View statistics:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py stats

Clear all memories:

# Use with caution - irreversible
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py clear --yes

Batch Import

For importing conversation histories from JSONL files, see references/import-guide.md.

Custom Table Names

Use different tables to organize conversation contexts:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py --table-name my_custom_table add --speaker "User" --content "Message"

Data Format

All dialogues are stored with:

• speaker: Who said it (string)
• content: What was said (string)
• timestamp: When it was said (ISO 8601 datetime, auto-generated if omitted)

Advanced Usage

For detailed information:

• OpenRouter setup and model selection: references/openrouter-guide.md
• JSONL import format and batch operations: references/import-guide.md
• CLI command reference: references/cli-reference.md
• System architecture and configuration: references/architecture.md

Setup

Install dependencies:

cd ~/.claude/skills/simplemem-skill
pip install -r requirements.txt

Configure OpenRouter API:

cp src/config.py.example src/config.py
# Edit src/config.py and set your OPENROUTER_API_KEY

See references/openrouter-guide.md for API key setup and model customization.

Data storage: Memories persist in data/lancedb/ (auto-created).