TrackFlow for VS Code ✨

Understand your code, automatically. TrackFlow is a VS Code extension that seamlessly tracks your coding activity, providing you with powerful, AI-generated daily summaries of your work.
TrackFlow helps you understand your productivity patterns, see where your time goes, and get a high-level overview of your progress without any manual effort. It's designed for developers who value their time and want to gain insight into their coding habits.
🚀 Features
- 🤖 AI-Powered Daily Summaries: Connects to the TrackFlow web service to provide you with insightful, human-readable summaries of your previous day's work.
- ⏱️ Automatic & Manual Time Tracking: You are in control. Start and stop your coding sessions manually, or enable auto-start to have a session begin as soon as you start typing.
- 📝 Detailed Code Diffs: Understand exactly what changed. The extension intelligently tracks file modifications and sends a "diff" at the end of each session.
- 🌐 Seamless Web Dashboard Integration: Authenticate once and easily jump to your full web dashboard to view historical data, streaks, and detailed stats.
- ⚙️ Customizable Settings: Tailor the extension to your needs, including the timer display format and auto-start behavior, directly within VS Code's settings UI.
- 🔒 Privacy-Focused: Your code never leaves your machine. Only the diffs (the changes between your code's starting and ending state) are sent to generate summaries.
- 🖥️ Intuitive Status Bar UI: All primary controls are available at a glance in your VS Code status bar for quick access.
📦 Installation
- Install the Extension: Install TrackFlow from the VS Code Marketplace.
- Create a TrackFlow Account: If you haven't already, sign up for a free account on the TrackFlow website.
- Log In:
- Open the Command Palette (
Ctrl+Shift+P
or Cmd+Shift+P
).
- Run the command
TrackFlow: Login
.
- Your browser will open for you to authenticate your account. After logging in, you'll be redirected back to VS Code.
- Start Tracking:
- Click the
▶️ Start Tracking
button in the status bar at the bottom-right of your window.
🕹️ How to Use
Control the TrackFlow extension primarily via the status bar and the Command Palette.
Status Bar Controls
The status bar provides quick access to the most common actions:
State |
Status Bar Display |
Action |
Logged Out |
[⚙️] [👤 TrackFlow: Login] |
Click to log in. |
Session Stopped |
[⚙️] [▶️ Start Tracking] |
Click to begin a new coding session. |
Session Active |
[⚙️] [⏹️ 00:05:23] |
Shows the running timer. Click to stop. |
Settings Icon |
⚙️ (Always visible) |
Click to open TrackFlow settings. |
⌨️ Available Commands
All features are accessible via the Command Palette (Ctrl+ShiftP
or Cmd+Shift+P
):
🛠️ Extension Settings
Customize the extension to fit your workflow. Access these settings via the TrackFlow: Open Settings
command or by clicking the gear icon ⚙️
in the status bar.
Setting |
Default |
Description |
trackflow.autoStartSession |
false |
Automatically start a new coding session when you start typing. |
trackflow.timerFormat |
hh:mm:ss |
The display format for the session timer in the status bar. |
🐛 Feedback & Contributions
Found a bug or have a feature request? Please open an issue on our GitHub Repository.
We welcome contributions! Please feel free to fork the repository and submit a pull request.
📄 License
This extension is licensed under the MIT License. See the LICENSE file for more details.