mcpField
A
agent-memory

agent-memory

github.com/molty-assistantAgent workflows0341 installsUpdated 38w ago
Repository

About agent-memory

agent-memory is a CLI for AI agents to organize, search, and maintain memory files. It includes activity summaries, gap checks, and an optional Gemini-based digest.

Key features

  1. 01List memory files and recent entries
  2. 02Search files with surrounding context
  3. 03View activity summaries by date range
  4. 04Find missing daily entries
  5. 05Create dated files and generate AI digests

Use cases

  1. 01Check for missing entries during daily maintenance
  2. 02Generate a weekly digest for review
  3. 03Find project context across memory files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/molty-assistant/agent-memory-skill --skill agent-memory

After installing, type/agent-memoryin Claude Code to confirm it loaded.

Bundled filespackage.json

Details

From the project README

Agent Memory (memctl)

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

Install

npm install -g agent-memory

Or clone and build:

git clone https://github.com/molty-assistant/agent-memory.git
cd agent-memory && npm install && npm run build

Commands

List memory files
memctl list              # List all
memctl ls --recent 5     # Show recent
Search across files
memctl search "query"              # Find mentions
memctl s "project" --context 3     # With context lines
Summary stats
memctl summary           # Last 7 days stats
memctl sum --days 30     # Last 30 days
Check for gaps
memctl gaps              # Missing daily entries (30 days)
memctl gaps --days 7     # Check last week
Create today's file
memctl touch             # Creates YYYY-MM-DD.md if missing
AI-powered digest (requires Gemini API key)
export GEMINI_API_KEY=your_key
memctl digest            # AI summary of last 7 days
memctl ai --days 3       # Last 3 days
memctl digest -o out.md  # Save to file

Configuration

Memory directory is found automatically:

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

Use Cases

Daily check:

memctl gaps --days 7 && memctl touch

Weekly review:

memctl digest --days 7 -o weekly-digest.md

Find context:

memctl search "project name"

Integration

Add to your HEARTBEAT.md:

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

Comments

Markdown supported