timesheet-generator

[](https://www.npmjs.com/package/timesheet-generator) [](https://nodejs.org/) [](https://opensource.org/licenses/MIT) [](https://github.com/TakasiVenkataSandeep-08/timesheet-generator)

Best-in-class automated timesheet generation from git commits with intelligent time estimation

> 🚀 Zero-config, plug-and-play timesheet automation

• ✅ Intelligent Time Estimation - Estimates actual work time from commit patterns using gap analysis, complexity scoring, and message hints
• ✅ Zero-Config - Works out-of-the-box with smart defaults (auto-detects author, timezone, work hours)
• ✅ Multiple Output Formats - JSON, CSV, Markdown, Jira-compatible CSV, PDF, HTML, Simple mode
• ✅ Plugin Architecture - Extensible VCS adapters (Local Git, GitHub, GitLab) and formatters
• ✅ Smart Session Grouping - Groups commits into logical work sessions based on time gaps
• ✅ Ticket Extraction - Automatically extracts Jira/Linear/GitHub issue IDs from commit messages
• ✅ Project Categorization - Categorizes work by project/branch/file patterns with auto-detection
• ✅ Multi-Repository Support - Aggregate timesheets from multiple repositories in parallel
• ✅ Time Tracking Integrations - Direct API integration with Jira, Linear, Toggl, Clockify
• ✅ MCP Server - Model Context Protocol server for AI tool integration (Claude, Cursor)
• ✅ Holiday Detection - Excludes holidays from work sessions (configurable by country/state)
• ✅ Work Pattern Learning - Auto-detects work hours from historical commit patterns
• ✅ Interactive CLI - Configuration wizard and validation tools
• ✅ Structured Logging - Debug-friendly logging with file out