Git Timesheet

A tool to generate timesheets from git history

Features

• Generate timesheets from git commit history
• Customizable date ranges & windows
• Support for multiple output formats (PRs welcome)
• Support for multiple vcs (PRs welcome)
• Supports multiple repositories

TODOs (looking for help)

• Workspace and project grouping
• User and team grouping

Installation

bun add -g @samcullin/git-timesheet
npm install -g @samcullin/git-timesheet
pnpm install -g @samcullin/git-timesheet
yarn add global @samcullin/git-timesheet

Usage

git-timesheet -h

Usage: git-timesheet [options] [command]

Generate timesheet reports from git history

Options:
  -V, --version            output the version number
  -s, --start-date <date>  Start date (YYYY-MM-DD)
  -e, --end-date <date>    End date (YYYY-MM-DD)
  -w, --window <window>    Time window (e.g., 1d, 1w, 1m, 1y)
  -f, --format <format>    Output format (markdown, json, html)
  -r, --repo <path>        Repository path (defaults to current directory)
  -h, --help               display help for command

Commands:
  repo
  author
  show                     Show current configuration

git-timesheet --window 1w

For more detailed usage instructions and options, see our documentation.

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.