Codeflow Coach

An intelligent productivity and well-being coach for VS Code, designed to help you write better code, improve your workflow, and maintain good coding habits. 🙂

What's new in v2

Codeflow Coach v2 grows from a simple tip pop-up into a small productivity suite:

• Focus Sessions (Pomodoro-style): Start a timed, distraction-minimizing focus session (15/25/45/60 min) right from the status bar or Command Palette.
• Status Bar Companion: A persistent status bar item shows your current focus countdown, snooze status, or day streak — click it to open the Codeflow Coach menu.
• Coding Dashboard: A new webview panel visualizes your stats — day streak, tips shown/acted on, breaks taken, and focus minutes.
• Snooze Ergonomics Reminders: Need to power through something? Snooze break reminders for 15/30/60 minutes.
• Idle-Aware Breaks: Ergonomics reminders skip themselves while the VS Code window isn't focused, so you won't get nagged while you're away.
• Tip Categories: Enable or disable groups of pro-tips (General, Navigation, Editing, Git, Debugging) individually in settings.
• More Pro-Tips: New tips covering Zen Mode, split editors, Emmet abbreviations, multi-occurrence selection, code folding, breadcrumbs, and more.

Features

• Smart Pro-Tips: Get contextual suggestions and tips for VS Code features and best practices directly in your editor. Tips appear based on your activity (e.g., saving files, common typing patterns) and respect the categories you've enabled.
• Ergonomics Reminders: Receive gentle nudges to take breaks, stretch, or look away from the screen, promoting healthier coding habits. Skips itself automatically while VS Code is unfocused, and can be snoozed on demand.
• Focus Sessions: Start a Pomodoro-style focus session with one click; Codeflow Coach tracks completed sessions and total focus minutes, and offers a break when the session ends.
• Dashboard: See your day streak, tip engagement rate, break rate, and focus stats at a glance.
• Status Bar Menu: One click away from tips, dashboard, focus sessions, snoozing, resetting tips, and settings.
• Customizable Intervals: Adjust how often you receive ergonomics reminders, and the minimum delay between any two tips.
• Dismissible Tips: Easily dismiss tips you've seen or don't find useful.
• Reset Tips: If you want to see all tips again, you can reset them via the Command Palette.

How to Use

1. Installation: Install "Codeflow Coach" from the VS Code Marketplace.
2. Automatic Activation: The extension activates automatically when VS Code starts, and adds a status bar item on the right side.
3. Pro-Tips: Keep an eye out for information messages appearing at the top of your editor. These are your pro-tips!
4. Ergonomics Reminders: You'll receive regular reminders to take a break — snooze them any time from the status bar menu.
5. Focus Sessions: Click the status bar item (or run the command) to start a focus session; a live countdown replaces the status bar text until it ends.
6. Dashboard: Open the dashboard any time to review your stats.
7. Settings:
   • Go to File > Preferences > Settings (or Code > Settings on macOS).
   • Search for "Codeflow Coach".
   • Adjust Ergonomics Reminder Interval Minutes to set how often you receive break reminders (set to 0 to disable).
   • Adjust Min Tip Delay Seconds to control the minimum time between any two pro-tips.
   • Toggle Skip Breaks When Unfocused to control whether reminders fire while the window is in the background.
   • Toggle individual entries under Tip Categories to turn whole groups of tips on or off.
8. Commands (via Command Palette Ctrl+Shift+P / Cmd+Shift+P):
   • Codeflow Coach: Open Menu — quick access to everything below.
   • Codeflow Coach: Show Current Tips — manually see available tips.
   • Codeflow Coach: Show Dashboard — view your stats.
   • Codeflow Coach: Start Focus Session / Stop Focus Session — manage focus sessions.
   • Codeflow Coach: Snooze Ergonomics Reminders — pause break reminders temporarily.
   • Codeflow Coach: Reset All Dismissed Tips — see dismissed tips again.

Settings Reference

Privacy

All stats and preferences are stored locally via VS Code's built-in extension storage. Codeflow Coach makes no network requests and collects no telemetry.

Contributing

Issues and pull requests are welcome on the GitHub repository.

License

The MIT License (MIT)