Back to Home

Documentation

Complete guide to using Simple Coding Time Tracker

📑 Table of Contents

📖 Overview

Simple Coding Time Tracker is a powerful VS Code extension that automatically tracks your coding time across projects, Git branches, and programming languages. It provides detailed insights into your coding habits with beautiful visualizations and comprehensive statistics.

Key Features

🚀 Getting Started

Installation

  1. Open Visual Studio Code
  2. Go to Extensions view (Ctrl+Shift+X or Cmd+Shift+X on macOS)
  3. Search for "Simple Coding Time Tracker"
  4. Click "Install"

✅ Installation Complete!

The extension will automatically start tracking when you begin coding. Check the status bar at the bottom of VS Code to see your today's coding time.

First Use

Once installed, the extension works automatically:

  1. Open a project in VS Code
  2. Start coding - tracking begins automatically
  3. View your stats by clicking the status bar or running SCTT: Show Coding Time Summary

⚙️ Configuration Settings

Access settings via VS Code Settings (Ctrl+,) or use the dedicated Settings View by clicking "Settings" in the summary view.

Setting Description Default
inactivityTimeout Minutes of inactivity before pausing tracking 2.5 minutes
focusTimeout Continue tracking after VS Code loses focus (minutes) 3 minutes
health.enableNotifications Enable/disable health notifications false
health.modalNotifications Make health notifications modal (blocks UI) true
health.eyeRestInterval Eye rest reminder frequency (minutes) 20 minutes
health.stretchInterval Stretch reminder frequency (minutes) 30 minutes
health.breakThreshold Break suggestion after continuous coding (minutes) 90 minutes

Recommended Settings

💡 Productivity Tips

  • Inactivity Timeout: Set to 2-3 minutes for accurate tracking without gaps
  • Focus Timeout: Set to 3-5 minutes if you frequently switch to browsers or documentation
  • Health Notifications: Enable for better coding health and productivity

🎯 Feature Details

Automatic Time Tracking

The extension tracks time based on:

Git Branch Tracking

Automatically monitors your current Git branch and associates coding time with it. When you switch branches, the extension:

  1. Saves the current session with the old branch
  2. Starts a new session for the new branch
  3. Maintains separate statistics for each branch

Language Detection

Supports 50+ programming languages including:

Interactive Visualizations

Project Summary Chart

Displays time distribution across different projects with interactive tooltips showing exact durations.

Daily Activity Timeline

Line chart showing your coding patterns over time, helping identify your most productive hours.

Activity Heatmap

3-month calendar view showing coding intensity, similar to GitHub contribution graphs.

Language Distribution

Pie chart showing time spent in different programming languages.

Advanced Filtering

Filter your data by:

💪 Health Notifications

The health notification system promotes healthy coding habits based on scientific research:

Eye Rest Reminders (20-20-20 Rule)

Default: Every 20 minutes

Reminds you to look at something 20 feet away for 20 seconds. This scientifically-proven technique helps prevent eye strain and digital eye fatigue.

👁️ Why It Matters

Prolonged screen time can cause Computer Vision Syndrome (CVS). The 20-20-20 rule gives your eye muscles a chance to relax and reduces strain.

Stretch Reminders

Default: Every 30 minutes

Prompts you to stand up and stretch your back and neck. Regular stretching prevents muscle tension and improves posture.

Break Suggestions (Ultradian Rhythms)

Default: Every 90 minutes

Based on the body's natural 90-minute ultradian rhythm cycles. Taking breaks at these intervals maximizes focus and prevents burnout.

Notification Actions

Each health notification offers two options:

Modal vs. Non-Modal

By default, health notifications are modal (they block the UI until dismissed). This ensures you actually take a break. You can disable this in settings if you prefer non-blocking notifications.

⌨️ Available Commands

Access commands via Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS):

Command Description
SCTT: Show Coding Time Summary Opens the main summary view with charts and statistics
SCTT: Open Settings Opens the dedicated settings view
SCTT: Toggle Health Notifications Quickly enable/disable health notifications
SCTT: View Time Tracking Data Exports raw tracking data as JSON
SCTT: Clear All Time Tracking Data Deletes all tracking data (with confirmation)
SCTT: Generate Test Data (Dev) Creates test data for 90 days (development only)
SCTT: Delete Test Data (Dev) Removes all test data (development only)

⚠️ Development Commands

Test data commands are hidden by default. Enable enableDevCommands in settings to access them. These are intended for testing and development purposes only.

💾 Data Management

Data Storage

All tracking data is stored locally in VS Code's storage. Your data never leaves your machine.

Exporting Data

Use SCTT: View Time Tracking Data to export your data as JSON format. This includes:

Clearing Data

To delete all tracking data:

  1. Run SCTT: Clear All Time Tracking Data
  2. Confirm the action in the dialog
  3. All data will be permanently deleted

⚠️ Warning

Clearing data is permanent and cannot be undone. Export your data first if you want to keep a backup.

Data Privacy

🔧 Troubleshooting

Extension Not Tracking Time

Solution:

Status Bar Not Showing

Solution:

Git Branch Not Detected

Solution:

Health Notifications Not Appearing

Solution:

Performance Issues

Solution:

❓ Frequently Asked Questions

Does this extension send my data anywhere?

No. All data is stored locally in VS Code's storage. Nothing is sent to external servers. Your privacy is fully protected.

Will this slow down VS Code?

No. The extension is designed to be lightweight and runs efficiently in the background without impacting performance.

Can I use this for billing clients?

Yes! The extension provides accurate time tracking that you can export and use for billing purposes. However, always review the tracked time before billing.

What happens if I forget to close VS Code overnight?

The smart activity detection will automatically pause tracking after the configured inactivity timeout (default: 2.5 minutes).

Can I track time across multiple machines?

Currently, data is stored locally per machine. To sync across machines, you would need to export and manually combine the data.

How accurate is the time tracking?

Very accurate! The extension tracks actual keyboard and mouse activity. It automatically excludes periods when you're away from your desk or not actively coding.

Can I customize the charts and visualizations?

The charts automatically adapt to your VS Code theme (light/dark). Currently, chart types are fixed, but we're considering adding customization options in future versions.

Is my data backed up?

Data is stored in VS Code's storage, which persists across sessions. However, it's not automatically backed up. Use the export feature to create manual backups.

Need More Help?

Check out these additional resources:

Wiki Documentation Report an Issue View on GitHub