recap
rohitg00/agentmemory
Summarize recent agent sessions grouped by date with key observations from project memory.
What is recap?
Recap retrieves and organizes the last N agent sessions for your current project, grouped by calendar date with highlighted observations per session. Use it when you need a rollup of recent work, progress on specific dates, or want to understand what's been accomplished over a time window (today, this week, or last N sessions).
- Parse time window arguments (today, this week, last N, or default last 10 sessions)
- Retrieve sessions filtered to the current project's working directory
- Group sessions by local calendar date (YYYY-MM-DD)
- Display session ID, title/first prompt, observation count, and status
- Extract and indent 2-3 high-importance observations (≥7) per session
- Report totals: N sessions across M days, K observations
How to install recap
npx skills add https://github.com/rohitg00/agentmemory --skill recap- memory_sessions tool must be available
- memory_recall tool must be available
- Current project working directory must be set
How to use recap
- 1.Invoke the skill with a time window argument: 'recap today', 'recap this week', 'recap last 5', or 'recap' (defaults to last 10)
- 2.The skill parses your argument and queries memory_sessions for matching sessions in your project
- 3.Sessions are grouped by date and sorted with most recent first
- 4.For each session, key observations (importance ≥7) are retrieved and displayed as indented highlights
- 5.Review the summary to understand recent progress, then ask follow-up questions about specific sessions if needed
Use cases
- Ask 'what have we been doing this week?' to see project progress grouped by date
- Request 'recap today' to review all work completed in the current session date
- Use 'last 5' to focus on the most recent 5 sessions and their key findings
- Check 'this week' to understand scope and highlights across multiple days of work
- Verify session history before handing off to another agent or team member
- Agents needing to summarize their own recent work
- Users reviewing project progress over time
- Teams coordinating handoffs between sessions or agents
- Developers tracking what was accomplished across multiple coding sessions
recap FAQ
The skill returns 'No sessions in the last N days for this project.' It does not invent activity from conversation memory.
Sessions are matched against your current working directory (cwd). Only sessions from the same project directory are included.
Highlights are retrieved via memory_recall with importance ≥7. They are not paraphrased; they come directly from stored observations.
'today' (current local date), 'this week' (last 7 days), 'last N' or a bare number (most recent N sessions), or empty (defaults to last 10).
Yes. The recap provides a structured summary of recent work that another agent can review before continuing the project.
Full instructions (SKILL.md)
Source of truth, from rohitg00/agentmemory.
name: recap description: Summarize the last N agent sessions for the current project, grouped by date, with highlight observations per session. Use when the user asks "recap", "what have we been doing", "today", "this week", or wants a rollup of recent work. argument-hint: "[last N | today | this week]" user-invocable: true
The user wants a recap. Time window args: $ARGUMENTS
Quick start
memory_sessions { "limit": 30 }
Then per surviving session: memory_recall { "query": "<top concepts>", "limit": 3 }.
Expected output:
2026-06-07
7f3a9c2 · "Auth refresh rework" · 14 obs · completed
- [8] Rotate refresh tokens on every use
3 sessions across 2 days, 41 observations.
Why
Only summarize sessions and observations the tools returned. An empty window is a real answer, not a prompt to invent activity.
Workflow
- Parse
$ARGUMENTS:today= current local date;this week= last 7 days;last <n>or bare numeric = most recent N; empty =last 10. - Call
memory_sessions, filter to the current project (matchcwdagainst the working directory), apply the window, sort bystartedAtdescending. - Group survivors by local calendar date (YYYY-MM-DD).
- Per session list id (first 8), title or first prompt, observation count,
status. Indent 2-3 highlights (importance >= 7) from
memory_recall. - End with "N sessions across M days, K observations."
Anti-patterns
WRONG: window is empty, so you summarize "a productive week of auth work" from memory of the conversation.
RIGHT: "No sessions in the last 7 days for this project."
Checklist
- Window parsed correctly from the argument.
- Sessions filtered to the current project's cwd.
- Highlights come from
memory_recall, not paraphrase. - Totals line reflects the actual counts shown.
See also
handoff,session-history,recall: same session data, different lens.
Troubleshooting
See ../_shared/TROUBLESHOOTING.md if memory_sessions or memory_recall is not available.
Related skills
More from rohitg00/agentmemory and the wider catalog.
remember
Save insights and decisions to searchable long-term memory with concept tags.
recall
Search past observations and learnings using hybrid BM25, vector, and graph search.
session-history
Display a clean timeline of recent project sessions and what was accomplished in each.
forget
Delete specific observations from agentmemory with explicit user confirmation.
commit-context
Trace code back to the agent session that created it—answer 'why is this here' and 'what was the agent doing'.
handoff
Resume the most recent agent session for your project, picking up from any unanswered question.