Trackify - Code Change Tracker for VS Code

Trackify is a VS Code extension that meticulously tracks and analyzes your coding patterns. It monitors file changes, typing behavior, Git interactions, and window focus events, generating detailed analytics about your coding sessions. This data can be used for valuable insights and productivity analysis.

Features

Comprehensive Change Tracking: Automatically tracks all code modifications within your workspace, including edits, insertions, and deletions.
Intelligent Event Detection:
- Detailed typing sessions with speed (characters per second) and pattern analysis (min/max/average change lengths).
- Detection of copy-paste operations.
- Monitoring of file events: renames and saves.
- Tracking of window focus duration.
- Captures full line content when suggestions or tab completions are accepted, providing complete context.
Git Integration:
- Tracks essential Git metadata: username, email, repository URL, branch, and Git provider (GitHub, GitLab, Bitbucket).
- Supports .gitignore patterns to exclude specified files from tracking.
- Monitors commit ID changes to contextualize code modifications.
Detailed Analytics & Storage:
- Records characters typed, spaces used, line changes, and their positions.
- Calculates line hashes for precise change detection and avoids duplicate tracking of unchanged lines.
- Stores all event data locally in a .trackify.jsonl file in your workspace root.
- All tracked data is encrypted locally before being stored.
Privacy-Focused:
- Designed with privacy as a priority: only tracks metadata about changes.
- Never stores the actual content of your code.
Workspace Integration: Seamlessly works with any workspace and automatically initiates tracking.
Configuration:
- Allows setting a server URL and API key for optional secure data synchronization to a backend service.
Version Tracking: Embeds the extension version in each event for better data analysis and issue tracking.

Installation

Install the "Trackify" extension from the VS Code Marketplace.
Open a workspace or folder in VS Code.
The extension will automatically start tracking changes in the background.

Usage

Trackify operates automatically once a workspace is open. All events are encrypted and stored in a .trackify.jsonl file located in the root of your workspace.

Available Commands

You can access these commands via the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on Mac):

Trackify: Clean Tracking File: Clears all locally stored tracking history from the .trackify.jsonl file.
Trackify: Show Logs: Opens the extension's output channel, displaying logs for debugging and monitoring.
Trackify: Sync Now: Manually triggers the synchronization of tracked data to the configured server (if server URL and API key are set).
Trackify: Set Server URL: Prompts for and saves the server URL for data synchronization.
Trackify: Set API Key: Prompts for and saves the API key for server authentication.
Trackify: Stop Sync Service: Stops the automatic background synchronization service.

Event Data Example (Illustrative)

Events stored in .trackify.jsonl are in JSON Lines format. Here's an example of an edit event:

{
  "eventTime": 1672608858129,
  "eventName": "EDIT",
  "eventType": "INSERT",
  "file": "/Users/dev/my-project/src/feature.ts",
  "startLine": 10,
  "endLine": 10,
  "lineChanges": 1,
  "spaces": 4,
  "characters": 25,
  "duration": 1.85,
  "typingSpeed": 13.51,
  "changeCount": 1,
  "avgChangeLength": 25,
  "maxChangeLength": 25,
  "minChangeLength": 25,
  "isCopyPaste": false,
  "fullLineContents": ["const newMessage = 'Hello, Trackify!';"],
  "cursorLine": 10,
  "cursorCharacter": 29,
  "focusedFile": "/Users/dev/my-project/src/feature.ts",
  "windowState": "focused",
  "lineHashes": ["a1b2c3d4"],
  "gitUsername": "devuser",
  "gitEmail": "devuser@example.com",
  "gitRepoUrl": "https://github.com/user/my-project.git",
  "gitRepoName": "user/my-project",
  "gitProvider": "github",
  "gitBranch": "main",
  "language": "typescript",
  "version": "0.0.10"
}

Requirements

VS Code version 1.74.0 or higher.
A workspace or folder must be open for tracking to begin.

Privacy

Trackify is built with your privacy in mind:

Local Data Storage: All data is stored locally in your workspace in the .trackify.jsonl file.
Encryption: Data is encrypted before being written to the local file.
Metadata Only: Only metadata about your coding activity (e.g., lines changed, typing speed, file names) is tracked. The actual content of your code is never stored or transmitted.
Optional Sync: Data is only sent to an external server if you explicitly configure a server URL and API key and the sync service is active.
User Control: You can clear all tracked data at any time using the Trackify: Clean Tracking File command.

Known Issues

Performance in extremely large workspaces with very frequent changes might be impacted.
Copy-paste detection relies on clipboard access and might have limitations with certain external clipboard managers.

trackify

arunp0