oma-recap

1# AI Tool Conversation History Summary
2 
3Analyze AI tool conversation histories for a given period and generate themed work summaries.
4 
5## Scheduling
6 
7### Goal
8Collect AI tool conversation history for a date or window and synthesize it into a themed, project-oriented recap with saved Markdown output.
9 
10### Intent signature
11- User asks for daily recap, weekly/monthly summary, standup notes, work log, tool usage pattern, or AI conversation history analysis.
12- User wants conversation histories grouped by work content rather than raw chronological logs.
13 
14### When to use
15- Summarizing a day or period of work activity
16- Understanding the overall flow of work across multiple AI tools
17- Analyzing tool-switching patterns between sessions
18- Preparing daily standups, weekly retros, or work logs
19 
20### When NOT to use
21- Git commit-based code change retrospective -> use `oma retro`
22- Real-time agent monitoring -> use `oma dashboard terminal`
23- Productivity metrics -> use `oma stats get`
24 
25### Expected inputs
26- Date, relative date, time window, or tool filter
27- Conversation history available through `oma recap --json` or fallback sources
28- Desired daily or multi-day recap scope
29 
30### Expected outputs
31- Markdown recap saved to `.agents/results/recap/{date}.md` or range filename
32- TL;DR, overview, themes/projects, miscellaneous or side projects, and tool usage patterns
33- User-facing summary in configured response language
34 
35### Dependencies
36- `oma recap --json`
37…