Code Tracker Official

Unlock insights into your coding habits! Code Tracker Official automatically tracks your active coding time, monitors changes across your files, and leverages AI to provide a concise daily summary of your accomplishments.

Stop wondering where your time went and start understanding your development workflow better.

Features

• Automatic Time Tracking: Measures your active coding time within VS Code, automatically pausing during inactivity.
• Intelligent Diff Monitoring: Captures the changes (diffs) you make to your files during a coding session.
• AI-Powered Daily Summaries: At the end of each day (configurable), receive an AI-generated summary of your coding activities based on the tracked time and code changes. Understand what you've built, fixed, or refactored.
• Secure Authentication: Securely log in to link your VS Code activity with your Code Tracker account. Your data is associated with your user profile.
• Local Data Storage: Time logs and diffs are sent to your configured backend server where they are stored securely in MongoDB.
• Configurable Inactivity Timeout: Customize how long the extension waits before considering you inactive.

How It Works

1. Install & Login: Install the extension. You'll be prompted to log in. This will open a secure web page where you can register or sign in to your Code Tracker account.
2. Code as Usual: The extension runs in the background. As you code, it tracks your active time and notes which files you modify.
3. Session Management: Sessions automatically start when you begin coding and end after a period of inactivity or when you close VS Code. Data (time and diffs) is sent to your backend at the end of each session.
4. Daily AI Summary: A scheduled process on your backend server analyzes all your sessions for the day and generates a high-level summary of your work, which is then stored. (Currently, summaries are logged on the server; future versions may deliver these within VS Code or via other channels).

Getting Started

1. Install the Extension from the VS Code Marketplace.
2. Set up the Backend Server:
   • This extension requires a backend server to store data and generate AI summaries. You can find the server setup instructions at: [Link to your Server's GitHub Repo or Setup Guide - IMPORTANT!]
   • Ensure your server is running and accessible. By default, the extension tries to connect to http://localhost:3000. (Future versions may allow configuring this URL).
3. Login:
   • On first activation, or by running the command Code Tracker: Login (Ctrl+Shift+P, then type the command), you will be prompted to log in.
   • This will open your web browser to the login/registration page hosted by your Code Tracker backend.
   • Once logged in on the web, you'll be redirected back to VS Code, and the extension will be authenticated.
4. Start Coding! The tracker will begin monitoring your activity.

Commands

• Code Tracker: Login: Initiates the login process via your web browser.
• Code Tracker: Logout: Logs you out and clears your stored authentication token.
• Code Tracker: Show Login Status: Displays your current login status.

Configuration

(Currently, most configuration is handled on the server-side, such as OpenAI API keys and CRON schedules. The extension itself has minimal client-side configuration.)

• codetracker.userId (Legacy): A fallback user identifier if not logged in. Prefer using the login system.

Requirements

• An active internet connection to communicate with the backend server.
• A running instance of the Code Tracker backend server.
• (For AI Summaries) An OpenAI API key configured on the backend server.

Privacy

Your code diffs and session timings are sent to your configured backend server.

• If you are using the official backend (if you provide one): Please refer to our privacy policy [Link to your Privacy Policy].
• If you are self-hosting the backend: Your data remains on your server. The AI summaries are generated by sending diff context (not entire files) to the OpenAI API (or your configured AI provider).

We take your privacy seriously. The extension only tracks file modifications (diffs) and active coding time. It does not upload your entire codebase.

Known Issues & Limitations

• Currently, AI summaries are logged on the backend server. Future versions aim to display these within VS Code.
• The backend server URL is not yet configurable from within VS Code (defaults to http://localhost:3000).

Contributing

We welcome contributions! If you'd like to help improve Code Tracker Official, please check out our Contributing Guidelines (create this file if you want contributions) and the [issue tracker](https://github.com/eIonut/Trackflow-Extension/blob/HEAD/Link to your GitHub Issues).

Support

If you encounter any issues or have suggestions, please [file an issue on GitHub](https://github.com/eIonut/Trackflow-Extension/blob/HEAD/Link to your GitHub Issues).

Note: Replace TrackFlow.trackflow-official with your actual published ID in the badge URLs. Create the CONTRIBUTING.md and link to your actual GitHub repository, issue tracker, and any privacy policy or server setup guide.