name	wispr-flow
description	Generate daily, weekly, or monthly voice dictation recaps from Wispr Flow. Use when user says "what did I do today", "daily recap", "weekly recap", "monthly recap", "wispr recap", "show me my flow stats", "what apps did I use", "how much did I dictate", "what did I work on this week", or "what did I work on this month".

Wispr Flow — Voice Recap

Use this skill when the user asks about their daily, weekly, or monthly activity, what they worked on, or wants a recap of their Wispr Flow dictation history. Trigger phrases include: "what did I do today", "daily recap", "weekly recap", "monthly recap", "wispr recap", "show me my flow stats", "what apps did I use", "how much did I dictate", "what did I work on this week", "what did I work on this month".

What it does

Reads the local Wispr Flow SQLite database (~/Library/Application Support/Wispr Flow/flow.sqlite) and generates activity recaps.

Daily Recap

Overview stats: total dictations, words spoken, voice time, peak hour
App breakdown: which apps were used for dictation, ranked by usage with percentages and icons
Timeline: hour-by-hour activity with representative transcript snippets
Topic summary: what was worked on, grouped by app with sample quotes

Weekly Recap

Week overview: total dictations, words, voice time, app count, busiest day, peak hour
Day-by-day chart: visual bar chart of activity across the week
Hourly heatmap: when you're most active across the week
App breakdown: full week app usage with icons

Monthly Recap

Month overview: total dictations, words, voice time, app count, busiest day, peak hour
Daily average: dictations and words per active day
Week-by-week chart: visual bar chart of activity across weeks
Day-of-week heatmap: which weekdays are most active
Hourly heatmap: when you're most active across the month
App breakdown: full month app usage with icons

How to run

Daily CLI recap (prints markdown)

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/daily-recap.js

Daily HTML report (visual report saved to Desktop)

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/daily-recap.js --html

Daily — specific date

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/daily-recap.js --date=2026-02-05

Weekly CLI recap (current week, Mon–Sun)

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/weekly-recap.js

Weekly HTML report

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/weekly-recap.js --html

Weekly — specific week (pass any date in that week)

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/weekly-recap.js --week-of=2026-01-27

Monthly CLI recap (current month)

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/monthly-recap.js

Monthly HTML report

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/monthly-recap.js --html

Monthly — specific month

node /Users/cathrynlavery/.agents/skills/wispr-flow/scripts/monthly-recap.js --month=2026-01

Combine flags: --html --date=2026-02-05 or --html --week-of=2026-01-27 or --html --month=2026-01

After running

For CLI output: display the markdown output directly to the user
For HTML output: tell the user where the file was saved and offer to open it with open <path>
After showing raw stats, provide a brief AI summary: synthesize the transcript snippets into 2-3 sentences describing what the user worked on, their communication patterns, and any notable themes
If the user asks for both, run CLI first, then offer to also generate the HTML version
HTML reports include a Share button that lets users share stats to X or copy for LinkedIn

Design

HTML reports are styled to match the founder.codes design language:

Warm beige background (#f5f4ed), Instrument Serif headings, Inter body, JetBrains Mono labels
Coral accent (#f34e3f) for bars, badges, and links
App icons from the Mac App Store
Share button with X and LinkedIn options
Footer links: Wispr Flow affiliate · GitHub · founder.codes

Dependencies

better-sqlite3 (already installed in scripts/node_modules/)
Requires Wispr Flow desktop app to be installed with local history enabled

name	wispr-flow
description	Generate daily, weekly, or monthly voice dictation recaps from Wispr Flow. Use when user says "what did I do today", "daily recap", "weekly recap", "monthly recap", "wispr recap", "show me my flow stats", "what apps did I use", "how much did I dictate", "what did I work on this week", or "what did I work on this month".