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
- Click on the status bar item showing your current session time
- 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
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X
)
- Search for "TimeCraft"
- 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! 🚀