Oma Recap

Guardrails

1. Evidence status: A prompt alone proves a request, not a result. Mark work completed only with an explicit completion/result message, a receipt, or an artifact that supports the stated outcome. Mark it in progress with progress evidence; otherwise call it requested. Do not infer completion from a tool invocation or elapsed time.
2. TL;DR required: Top 3 supported outcomes. Use "completed" only when the evidence-status rule permits it; otherwise summarize requested or in-progress work plainly. Project name + status/outcome. No tool names or unnecessary detail.
3. Overview: After TL;DR, describe the flow. Start with "I" as subject and preserve evidence status.
4. Daily: themes by time block (15+ min). Rest goes to "Miscellaneous".
5. Multi-day (3d+): sections by project, ordered by activity. Read like a sprint report, not a daily log.
6. 2-4 bullets per theme/project: Concise essentials only. Don't enumerate every step.
7. Themes by content: Group by actual work, not by tool.
8. Time range (daily only): (AM/PM/Evening HH:MM~HH:MM). AM: 12:00, PM: 12:0018:00, Evening: 18:00~.
9. Save results: Write markdown to .agents/results/recap/.
10. Response language: Follows language setting in .agents/oma-config.yaml if configured.
11. No em dashes: Use commas, periods, or parentheses instead of — (em dash).

Process

1. Resolve Date

Determine the target date or window from the user's natural language input. Default is today.

Resolution rules:

• Relative day references (today, yesterday, day before yesterday, etc.) → calculate --date YYYY-MM-DD
• Specific date mentions (month + day, or full date) → convert to --date YYYY-MM-DD
• Relative weekday references (last Monday, this Friday, etc.) → calculate the date
• Period references (this week, last 3 days, past 2 weeks, etc.) → convert to --window Nd
• No date specified → today, resolved to --date YYYY-MM-DD (bare --window 1d is a rolling 24-hour window ending now, not the calendar day)
• The CLI caps windows at 30 days (longer values are trimmed with a warning) — when a requested period gets capped, say so in the recap

2. Collect Data

Extract normalized conversation history via CLI.

# Today (calendar day, all tools)
oma recap --date $(date +%F) --json

# Last 24 hours (rolling window ending now)
oma recap --json

# Time window (rolling, ends now; capped at 30d)
oma recap --window 7d --json

# Specific date
oma recap --date 2026-04-10 --json

# Tool filter (supported: grok, claude, codex, gemini, qwen, cursor, antigravity)
oma recap --tool claude,codex --json

Fallback when CLI is not installed: process Claude history only via inline jq:

# Uses the system timezone; export TZ=<zone> first to override, and state the
# timezone assumption in the recap (per the Failure and recovery rules).
TARGET_DATE=$(date +%Y-%m-%d)
# macOS/BSD date: advance the calendar date, then parse both local midnights.
next_date=$(date -j -v+1d -f "%Y-%m-%d %H:%M:%S" "${TARGET_DATE} 12:00:00" +%Y-%m-%d)
start_ts=$(date -j -f "%Y-%m-%d %H:%M:%S" "${TARGET_DATE} 00:00:00" +%s)000
end_ts=$(date -j -f "%Y-%m-%d %H:%M:%S" "${next_date} 00:00:00" +%s)000
# Linux/GNU date alternatives (replace all three lines above):
# next_date=$(date -d "${TARGET_DATE} 12:00:00 tomorrow" +%Y-%m-%d)
# start_ts=$(date -d "${TARGET_DATE} 00:00:00" +%s)000
# end_ts=$(date -d "${next_date} 00:00:00" +%s)000
# Do not add a fixed 24 hours: DST calendar days can have 23 or 25 hours.

jq -r --argjson start "$start_ts" --argjson end "$end_ts" '
  select(.timestamp >= $start and .timestamp < $end and .display != null and .display != "") |
  {
    time: (.timestamp / 1000 | localtime | strftime("%H:%M")),
    project: (.project | split("/") | .[-1]),
    prompt: (.display | gsub("\n"; " ") | if length > 150 then .[0:150] + "..." else . end)
  }
' ~/.claude/history.jsonl

3. Theme Analysis and Grouping

Read all extracted data and analyze with the following criteria:

Grouping rules:

• Only classify as a separate theme if the work spans 15+ minutes (based on timestamp gaps and prompt count)
• Merge consecutive prompts on the same topic into one theme
• Collect sub-15-minute tasks into a "Miscellaneous" section
• Group by work content, not by tool

Cross-tool analysis:

• Track workflow when multiple tools are used in the same time window
• Example: "Designed in Antigravity -> Implemented in Claude -> Reviewed in Codex"
• Derive insights from tool-switching patterns

Extract from each theme:

• Core work performed
• Key decisions made
• Tool combinations used
• Artifacts produced (docs, code, config, etc.)

4. Output Format

Save results to .agents/results/recap/{date}.md and display simultaneously.

Use the markdown templates in resources/output-formats.md:

• Daily format (1d or specific date): TL;DR → Overview → time-blocked themes → Miscellaneous → Tool Usage Patterns.
• Multi-day format (3d+): project-driven sprint-report structure with Side Projects for small (<30 prompts) work; follow the multi-day grouping rules in the same file.

Response language follows language setting in .agents/oma-config.yaml.

5. Save Results

Save to .agents/results/recap/{date}.md. For window ranges, use {start-date}~{end-date}.md format.

# Example paths
.agents/results/recap/2026-04-12.md
.agents/results/recap/2026-04-06~2026-04-12.md

References

• Output format templates: resources/output-formats.md
• Recap CLI: oma recap --json
• Output directory: .agents/results/recap/
• Language config: .agents/oma-config.yaml
• Claude fallback history: ~/.claude/history.jsonl