TimeCraft

Track your time, Master your project

Features

• Automatic Time Tracking: Monitors your coding sessions automatically when VS Code is active
• File Activity Tracking: Records time spent on specific files
• Detailed Reports: Generate comprehensive activity reports with visual calendar views
• Status Bar Integration: Real-time display of current session time
• Multiple Time Views: View activity by years, months, and days
• Export Options: Save reports as JSON and Markdown files

How It Works

timecraft automatically starts tracking when you open a workspace and VS Code is focused. It tracks:

• Session Time: Overall time spent in the workspace (5-minute intervals)
• File Activity: Time spent editing specific files (1-minute intervals)

Usage

Viewing Reports

1. Click on the status bar item showing your current session time
2. Or use the Command Palette: Ctrl+Shift+P → "Show Activity Report"

Generated Files

The extension creates these files in your workspace:

• timecraft.json - Raw time tracking data
• timecraft-report.json - Processed data for analysis
• timecraft-report.md - Human-readable markdown report

Status Bar

The status bar shows your current session time in format: ⌚ 2h 15:30

Report Example

## ⚡️ TimeCraft log

### 📅 2024
Total of activity time `45h 30m`

|     |            |     |            |     |            |
| --- | ---------- | --- | ---------- | --- | ---------- |
| Jan | `12h 45m`  | Feb | `8h 20m`   | Mar | `15h 30m`  |
| Apr | `9h 15m`   | May | `--`       | Jun | `--`       |

### 📅 January 2024
Total of activity time `12h 45m`

| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|-----|-----|-----|-----|-----|-----|-----|
| 01 `2h 30m` | 02 `1h 45m` | 03 `3h 15m` | ... |

Extension Settings

Configure the extension through VS Code settings:

• timecraft.activityLog.collections.session: Enable/disable session time tracking
• timecraft.activityLog.collections.activity: Enable/disable file activity tracking
• timecraft.activityLog.summaries.years: Include yearly summaries in reports
• timecraft.activityLog.summaries.months: Include monthly summaries in reports
• timecraft.activityLog.summaries.days: Include daily summaries in reports

Requirements

• VS Code version 1.74.0 or higher
• An open workspace (the extension requires a workspace folder to function)

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "TimeCraft"
4. Click Install

Privacy

All data is stored locally in your workspace. No data is sent to external servers.

Known Issues

• Time tracking only works when VS Code is focused and active
• Requires an open workspace folder to function properly

Release Notes

1.0.0

Initial release of TimeCraft

• Automatic time tracking for coding sessions
• File-specific activity monitoring
• Visual markdown reports with calendar views
• Status bar integration
• Local data storage

Contributing

Found a bug or have a feature request? Please open an issue on GitHub.

License

This extension is licensed under the MIT License.

Enjoy tracking your coding time! 🚀