Persistent memory toolkit for AI agents. Save context, recall with relevance scoring, consolidate insights, track decisions across sessions. Features importa...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Persistent memory for AI agents. Save what matters, recall what's relevant, consolidate what you've learned.
v2.0: relevance-scored search, importance levels, session context loader, consolidation, export/import, stats, edit/delete.
# Save a memory (with optional importance) MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Chose Postgres over SQLite for scale"Recall with relevance scoring
./scripts/recall.sh "database" --limit 5
Load session context (startup)
./scripts/context.sh --days 3
Consolidate by topic
./scripts/consolidate.sh --since 2026-01-01
Stats
./scripts/stats.sh
./scripts/save.sh "topic" "content" [tags...]
| Env | Default | Description |
|---|---|---|
| | Storage directory |
| | low / normal / high / critical |
# Basic save ./scripts/save.sh "insight" "Users prefer dark mode 3:1" ui designHigh importance
MEMORY_IMPORTANCE=high ./scripts/save.sh "decision" "Migrated to TypeScript" refactor
Critical (always surfaces in context.sh)
MEMORY_IMPORTANCE=critical ./scripts/save.sh "credential" "API key rotated, new one in vault"
./scripts/recall.sh "query" [--json] [--limit N] [--topic T] [--importance I] [--since YYYY-MM-DD]
Features:
./scripts/recall.sh "database migration" ./scripts/recall.sh "API" --topic decision --limit 20 ./scripts/recall.sh "deploy" --since 2026-03-01 --json ./scripts/recall.sh "error" --importance high
./scripts/context.sh [--days N] [--limit N] [--json]
Loads the most relevant memories for a new session:
# Quick context ./scripts/context.shWider window
./scripts/context.sh --days 7 --limit 30
For programmatic use
./scripts/context.sh --json
./scripts/daily.sh [YYYY-MM-DD] [--json]
./scripts/topics.sh [--json]
./scripts/consolidate.sh [--since YYYY-MM-DD] [--topic T] [--json]
Groups all memories by topic, showing counts, date ranges, top tags, and latest entries. Useful for periodic review.
./scripts/stats.sh [--json]
Shows: total entries, date range, entries/day average, storage size, topic breakdown, importance distribution.
./scripts/edit.sh <timestamp_ms> --content "new content" ./scripts/edit.sh <timestamp_ms> --topic "new topic" ./scripts/edit.sh <timestamp_ms> --importance critical ./scripts/edit.sh <timestamp_ms> --delete
./scripts/export.sh [-o backup.json] [--since YYYY-MM-DD] [--topic T]
./scripts/import.sh backup.json [--dry-run]
Deduplicates by timestamp ā safe to run multiple times.
./scripts/prune.sh [days]
Moves memories older than N days (default: 30) to
archive/~/.agent-memory/ āāā 2026/ ā āāā 01/ ā ā āāā 15.jsonl ā ā āāā 16.jsonl ā āāā 02/ ā āāā 01.jsonl āāā archive/ # Pruned memories
Each line is a JSON object:
{"ts":1706793600000,"topic":"decision","content":"Chose X because Y","tags":["project"],"importance":"high"}
| Level | When to Use | Behavior |
|---|---|---|
| Background info, minor notes | Only found via search |
| Standard memories | Shown in daily view |
| Key decisions, insights | Always in session context |
| Credentials, blockers, urgent | Always in session context, top priority |
# Session start ./scripts/context.shDuring work ā save important things
./scripts/save.sh "decision" "..." MEMORY_IMPORTANCE=high ./scripts/save.sh "insight" "..."
End of session
./scripts/save.sh "summary" "Today: did X, decided Y, next step Z"
Weekly review
./scripts/consolidate.sh --since $(date -u -d '7 days ago' +%Y-%m-%d) ./scripts/stats.sh
Monthly maintenance
./scripts/prune.sh 60 ./scripts/export.sh -o backup-$(date +%Y%m).json
Created by Voidborne š¹
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
Ā© 2026 Torly.ai. All rights reserved.