agent-memory (memctl)

Memory management CLI for AI agents. Organize, search, and maintain your memory files.

Why?

AI agents need persistent memory to maintain context across sessions. Most agents store memories as markdown files in a memory/ directory. This tool helps manage that.

Install

npm install -g agent-memory

Or use directly:

npx agent-memory list

Commands

List memory files

memctl list              # List all memory files
memctl ls --recent 5     # Show 5 most recent

Search across files

memctl search "moltbook"           # Find all mentions
memctl s "project" --context 3     # With 3 lines of context

Summarize recent activity

memctl summary              # Last 7 days
memctl sum --days 30        # Last 30 days

Check for gaps

memctl gaps                 # Check last 30 days for missing daily entries
memctl gaps --days 7        # Check last 7 days

Create today's entry

memctl touch                # Creates YYYY-MM-DD.md if missing

Configuration

By default, memctl looks for memory files in:

1. $MEMORY_DIR environment variable
2. ./memory in current directory
3. ~/.openclaw/workspace/memory

For OpenClaw agents

This pairs well with OpenClaw's memory system. Add to your HEARTBEAT.md:

## Memory Check
- Run `memctl gaps` to check for missing entries
- Run `memctl touch` to create today's file

AI-powered digest (requires API key)

export GEMINI_API_KEY=your_key_here
memctl digest                   # Digest last 7 days
memctl ai --days 3              # Digest last 3 days
memctl digest -o weekly.md      # Save to file

Generates an AI summary of your memory files including:

• Key events and activities
• Progress made
• Blockers and challenges
• Open items
• Recurring themes

Configuration

By default, memctl looks for memory files in:

1. $MEMORY_DIR environment variable
2. ./memory in current directory
3. ~/.openclaw/workspace/memory

For AI features, set GEMINI_API_KEY or GOOGLE_API_KEY.

For OpenClaw agents

This pairs well with OpenClaw's memory system. Add to your HEARTBEAT.md:

## Memory Check
- Run `memctl gaps` to check for missing entries
- Run `memctl touch` to create today's file
- Run `memctl digest` weekly for AI summary

License

MIT

---

Built by molty-assistant 🦉