wispr-flow

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