| name | slm-list-recent |
| description | List most recent memories in chronological order. Use when the user wants to see what was recently saved, review recent conversations, check what they worked on today, or browse memory history. Shows memories sorted by creation time (newest first). |
| version | 3.4.22 |
| license | AGPL-3.0-or-later |
| compatibility | Requires SuperLocalMemory V2 installed at ~/.claude-memory/ |
| attribution | {"creator":"Varun Pratap Bhardwaj","role":"Solution Architect & Original Creator","project":"SuperLocalMemory V2"} |
SuperLocalMemory: List Recent
List most recent memories in chronological order (newest first).
Usage
slm list [--limit N] [--project name] [--tags tag1,tag2] [--today|--week|--month]
Examples
Example 1: Last 10 Memories (Default)
$ slm list
Output:
📝 Recent Memories (10 most recent)
[ID: 1247] 5 minutes ago
Fixed JWT token refresh bug - tokens were expiring too fast
Tags: bug-fix, jwt, auth
Project: myapp
Importance: 8
[ID: 1246] 2 hours ago
React hooks best practices: useCallback for memoization
Tags: react, performance, hooks
Project: frontend-app
Importance: 6
[ID: 1245] 4 hours ago
Database migration strategy: use Alembic for versioning
Tags: database, postgresql, migration
Project: myapp
Importance: 7
[ID: 1244] Yesterday 18:42
Decided to use FastAPI over Flask for new microservice
Tags: python, backend, api, decision
Project: myapp
Importance: 9
[ID: 1243] Yesterday 15:30
Code review feedback: add more error handling to API endpoints
Tags: code-review, api, error-handling
Project: myapp
Importance: 6
...
Example 2: Last 5 Memories
$ slm list --limit 5
Example 3: Today's Memories
$ slm list --today
Shows only memories created today
Example 4: This Week
$ slm list --week
Shows memories from last 7 days
Example 5: Filter by Project
$ slm list --project myapp --limit 20
Shows 20 most recent memories from "myapp" project
Example 6: Filter by Tags
$ slm list --tags security,auth --limit 15
Shows 15 most recent memories tagged with security AND auth
Arguments
| Argument | Type | Required | Default | Description |
|---|
--limit | integer | No | 10 | Number of memories to show |
--project | string | No | All | Filter by project |
--tags | string | No | All | Filter by tags (comma-separated) |
--today | flag | No | - | Show only today's memories |
--week | flag | No | - | Show last 7 days |
--month | flag | No | - | Show last 30 days |
Sorting & Display
Chronological Order
Memories are always shown newest first (reverse chronological).
Rationale: Recent context is usually most relevant.
Timestamps
- "5 minutes ago" - Within last hour
- "2 hours ago" - Within last 24 hours
- "Yesterday 18:42" - Yesterday with time
- "Feb 05 14:23" - Older than yesterday
Content Preview
- First 200 characters shown
- Ellipsis (...) if truncated
- Use
slm recall --id <ID> for full content
Use Cases
1. Daily Standup Prep
slm list --yesterday
2. Resume Context
slm list --today --limit 5
3. Weekly Review
slm list --week --tags decision
4. Project Check-In
slm list --project myapp --limit 20
5. Security Audit
slm list --tags security --limit 100
Advanced Usage
Pagination
slm list --limit 10
slm recall --before-id 1237 --limit 10
Export to File
slm list --week > this-week.txt
slm list --format json --limit 100 > memories.json
Pipe to Other Commands
slm list --limit 1000 | grep "Project:" | sort | uniq -c
slm list --limit 500 | grep "Tags:" | tr ',' '\n' | sort | uniq -c | sort -rn
Combined with Other Skills
slm list --today
slm recall "FastAPI performance"
slm remember "FastAPI async endpoints improve throughput by 3x" --tags performance,fastapi
Output Formats
Standard Format (Default)
[ID: 42] Timestamp
Content preview...
Tags: tag1, tag2
Project: name
Importance: 7
Compact Format
slm list --format compact
42 | 5m ago | Content preview... | myapp
43 | 2h ago | Another memory... | default
JSON Format
slm list --format json
{
"memories": [
{
"id": 42,
"content": "Full content here",
"tags": ["tag1", "tag2"],
"project": "myapp",
"importance": 7,
"created_at": "2026-02-07T14:23:00Z"
}
],
"count": 10,
"total": 1247
}
CSV Format
slm list --format csv
id,content,tags,project,importance,created_at
42,"Content here","tag1,tag2",myapp,7,2026-02-07T14:23:00Z
43,"Another memory","tag3",default,5,2026-02-07T12:15:00Z
Performance
| Memory Count | List Time | Notes |
|---|
| 10 | ~50ms | Instant |
| 100 | ~200ms | Fast |
| 1,000 | ~500ms | Acceptable |
| 10,000+ | ~1s | Use filters |
Optimization tips:
- Use
--limit to reduce results
- Use
--project or --tags filters
- Use time filters (
--today, --week)
Troubleshooting
"No memories found"
Cause: Empty database or filters too restrictive
Solution:
slm status | grep "Total Memories"
slm list
slm list --project default
"List takes too long"
Cause: Large database, no filters
Solution:
slm list --limit 5
slm list --today --project myapp
slm build-graph
"Timestamps wrong"
Cause: System timezone changed
Solution:
date
Comparison with Search
| Feature | slm list | slm recall |
|---|
| Sorting | Chronological | Relevance |
| Use case | Browse recent | Find specific |
| Speed | Fast | Slower |
| Filters | Basic | Advanced |
| Scoring | No | Yes (relevance) |
Rule of thumb:
- Use
list when you want to see what you worked on recently
- Use
recall when you want to find specific information
Notes
- Read-only: Never modifies data
- Real-time: Shows latest state
- Cross-tool: Same list from Cursor, ChatGPT, Claude, etc.
- Privacy: All local, no external calls
Related Commands
slm remember - Save a new memory
slm recall - Search memories by relevance
slm status - Check memory count and stats
slm switch-profile - View different profile's memories
Created by: Varun Pratap Bhardwaj (Solution Architect)
Project: SuperLocalMemory V2
License: MIT (see LICENSE)
Repository: https://github.com/varun369/SuperLocalMemoryV2
Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.