convez.ai
PluginProdutividadeIntermediário
JustLucid-Cyber

GitCommitFlow - Gerador de Timesheet de Histórico Git

JustLucid-Cyber/git-log-timesheet-generator

Timesheets automáticos a partir do histórico Git com análise por IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta que converte automaticamente o histórico de commits Git em timesheets profissionais em PDF e CSV. Utiliza IA (OpenAI/Claude) para analisar commits, agregar múltiplos repositórios e calcular horas faturáveis, eliminando entrada manual de dados.

Instalação

$npx convez-ai JustLucid-Cyber/git-log-timesheet-generator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar relatórios de horas faturáveis para clientes a partir de commits
  • Agregar atividades de múltiplos repositórios em um único timesheet
  • Automatizar envio de relatórios de produtividade para folha de pagamento

Veredito

Plugin sólido para automação de timetracking baseado em commits, com suporte a IA e múltiplos formatos de export. Endereça bem um problema real de equipes de desenvolvimento, embora dependa de precisão do histórico Git e configuração adequada.

README

A tradução para o português deste README ainda está na fila.

GitCommitFlow: Automated PDF/CSV Timesheet Generator from Git History

Download

Effortless Time Tracking: Transform Your Git Logs into Professional Timesheets

Generate detailed weekly or monthly timesheets in PDF and CSV formats directly from your git commit history. GitCommitFlow eliminates manual time entry by parsing commit timestamps, messages, and branch activity to create accurate billable hour reports. Compatible with GitHub, GitLab, Bitbucket, and self-hosted git servers.

Version License PRs Welcome


🚀 Key Features

  • Automated Timesheet Generation – Convert git commit history into structured timesheets without manual data entry
  • Multi-Format Export – Generate PDF for clients and CSV for spreadsheets or payroll systems
  • AI-Powered Commit Analysis – Leverage OpenAI API and Claude API to summarize commit messages into human-readable task descriptions
  • Multi-Repository Support – Aggregate commits from multiple repositories into a single timesheet
  • Custom Date Ranges – Generate reports for any period: daily, weekly, monthly, or custom intervals
  • Billable Hour Calculation – Automatically compute hours based on commit timestamps with configurable work hours
  • Responsive Web Dashboard – Preview and edit timesheets before export with a modern, mobile-friendly interface
  • Multilingual Support – Generate timesheets in English, Spanish, French, German, Japanese, and Chinese
  • 24/7 Customer Support – Priority support for enterprise teams with automated email notifications

🧩 How It Works

graph TD
    A[Git Repository] --> B[Parse Commit History]
    B --> C[Extract Timestamps & Messages]
    C --> D[AI Analysis - OpenAI/Claude API]
    D --> E[Generate Task Descriptions]
    E --> F[Calculate Billable Hours]
    F --> G{Export Format}
    G --> H[PDF Timesheet]
    G --> I[CSV Timesheet]
    H --> J[Download or Email]
    I --> J
    style A fill:#4CAF50,stroke:#388E3C
    style J fill:#2196F3,stroke:#1565C0

📋 Example Profile Configuration

Create a .gitcommitflow.yaml file in your project root:

# GitCommitFlow Profile - timesheet-config.yaml
profile:
  name: "Project Alpha Development"
  owner: "Engineering Team"
  email: "team@example.com"
  rate: 150 # hourly rate in USD

repositories:
  - path: "./frontend-app"
    branch: "main"
    alias: "Frontend"
  - path: "./backend-api"
    branch: "develop"
    alias: "Backend API"
  - path: "./infrastructure"
    branch: "master"
    alias: "DevOps"

timezone: "America/New_York"
work_hours:
  start: "09:00"
  end: "18:00"
  lunch_break: "12:00-13:00"

ai:
  provider: "openai" # or "claude"
  model: "gpt-4"
  prompt_template: "Summarize the following git commits into professional task descriptions for a timesheet: {commits}"

export:
  format: "pdf" # pdf or csv
  period: "weekly" # daily, weekly, monthly, custom
  include_weekends: false
  logo: "./assets/company-logo.png"

💻 Example Console Invocation

Generate a weekly timesheet in PDF format:

gitcommitflow generate \
  --config ./timesheet-config.yaml \
  --period weekly \
  --format pdf \
  --output ./timesheets/week-12-2026.pdf

Generate a monthly CSV report with AI summaries:

gitcommitflow generate \
  --repo ./my-project \
  --from 2026-01-01 \
  --to 2026-01-31 \
  --format csv \
  --ai-summarize \
  --output ./reports/january-2026.csv

Preview timesheet in interactive dashboard:

gitcommitflow preview \
  --config ./timesheet-config.yaml \
  --port 8080

💻 Emoji OS Compatibility Table

Operating SystemStatusEmoji SupportNotes
Windows 11✅ Full Support❤️ 😊 🚀Native emoji rendering
Windows 10✅ Full Support❤️ 😊 🚀Update KB5023774+ required
macOS Ventura+✅ Full Support❤️ 😊 🚀Native Unicode 15 support
macOS Monterey✅ Partial❤️ 😊Some older emojis missing
Ubuntu 22.04+✅ Full Support❤️ 😊 🚀Install fonts-noto-color-emoji
Ubuntu 20.04✅ Partial❤️ 😊Limited emoji set
Fedora 36+✅ Full Support❤️ 😊 🚀Default emoji font included
Arch Linux✅ Full Support❤️ 😊 🚀Install noto-fonts-emoji

🔄 Feature List

Core Features

  • Git History Parser – Extracts commits from any git repository (local or remote)
  • Intelligent Time Deduction – Accounts for lunch breaks, meetings, and non-working hours
  • Multi-Branch Aggregation – Combine commits from feature branches, hotfixes, and main branch
  • Custom Templates – Design your own PDF layout with HTML/CSS templates

AI Integration

  • OpenAI API Integration – Uses GPT-4 to convert raw commit messages into professional descriptions
  • Claude API Integration – Alternative AI provider for teams preferring Anthropic models
  • Prompt Customization – Define system prompts for industry-specific terminology
  • Batch Processing – Process thousands of commits in a single API call

Export Capabilities

  • PDF Generation – Professional layouts with company branding, page numbers, and signatures
  • CSV Export – Compatible with Excel, Google Sheets, and payroll software
  • Email Delivery – Automatically send timesheets to managers or clients via SMTP
  • Cloud Storage – Direct upload to Google Drive, Dropbox, or OneDrive

User Interface

  • Responsive Web Dashboard – Accessible on desktop, tablet, and mobile devices
  • Dark Mode Support – Reduce eye strain during nighttime work sessions
  • Real-Time Preview – Edit commit descriptions and see updates instantly
  • Drag-and-Drop – Rearrange tasks and merge entries with mouse gestures

Team Collaboration

  • Multi-User Support – Generate timesheets for entire teams from unified configuration
  • Role-Based Access – Admin, editor, and viewer permissions
  • Comment System – Add notes to specific commits or time entries
  • Audit Log – Track changes to timesheets for compliance purposes

Security and Compliance

  • Local Processing – All git data stays on your machine; only summaries sent to AI APIs
  • GDPR Compliant – Data anonymization and right-to-delete features
  • SOC 2 Ready – Encryption at rest and in transit for enterprise deployments
  • API Key Management – Encrypted storage for OpenAI and Claude credentials

🤖 OpenAI API and Claude API Integration

GitCommitFlow is the first timesheet generator to natively support both OpenAI and Claude AI APIs for intelligent commit analysis.

OpenAI Integration

  • Model Support: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
  • Feature: Converts "fix typo" into "Corrected spelling errors in user authentication module"
  • Configuration: ai.provider: "openai" with your API key in environment variable

Claude Integration

  • Model Support: Claude 3 Opus, Claude 3 Sonnet, Claude 3 Haiku
  • Feature: Provides longer context windows for large repository histories
  • Configuration: ai.provider: "claude" with your API key in environment variable

AI Feature Highlights

  • Smart Deduplication – Merges consecutive commits on same feature into single entry
  • Context-Aware Summarization – Understands project structure from previous commits
  • Language Detection – Auto-detects and maintains language consistency
  • Hour Estimation – Predicts time spent based on commit frequency and code complexity

📦 Installation

Prerequisites

  • Python 3.9+ or Node.js 18+
  • Git 2.30+
  • OpenAI or Claude API key (for AI features)

Quick Install

Using pip (Python):

pip install gitcommitflow

Using npm (Node.js):

npm install -g gitcommitflow

Using Homebrew (macOS/Linux):

brew install gitcommitflow/tap/gitcommitflow

Docker:

docker pull gitcommitflow/gitcommitflow:latest
docker run -v $(pwd):/workspace gitcommitflow/gitcommitflow generate --config /workspace/config.yaml

Verify Installation

gitcommitflow --version
# Output: GitCommitFlow v2.4.1

🛠️ Configuration

GitCommitFlow uses YAML configuration files for reproducibility. Create a gitcommitflow.yaml in your repository root or use environment variables.

Environment Variables

VariableDescriptionDefault
GCF_API_KEYOpenAI or Claude API keyNone
GCF_TIMEZONEDefault timezoneUTC
GCF_RATEHourly billing rate100
GCF_OUTPUTOutput directory./timesheets

📊 Use Cases

Freelancers and Consultants

Generate professional timesheets for clients based on actual git activity. No more guessing what you worked on last week.

Engineering Teams

Automate monthly timesheet submissions for payroll. Managers can review aggregated team reports from unified dashboard.

Open Source Maintainers

Track contribution hours for grant reporting or community recognition. Generate reports that show the real cost of maintenance.

Agency and Contract Work

Separate commits by project or client using repository aliases. Generate consolidated invoices with embedded timesheets.


🌐 SEO-Optimized Keywords

  • git timesheet generator
  • automated time tracking from commits
  • pdf timesheet from git history
  • developer timesheet software
  • git commit to timesheet converter
  • ai timesheet summarization
  • openai timesheet integration
  • claude timesheet assistant
  • free timesheet generator for developers
  • weekly report from git commits
  • csv timesheet from git log
  • github timesheet tool
  • gitlab timesheet export
  • bitbucket timesheet generator
  • timesheet automation for programmers

These keywords naturally integrate into the application's functionality and documentation, helping developers discover GitCommitFlow through search engines.


📄 License

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

License


⚠️ Disclaimer

GitCommitFlow is provided "as is" without warranty of any kind, either express or implied. The tool analyzes git commit timestamps to estimate time spent; it does not guarantee that the generated hours match actual working time. Users are responsible for verifying and adjusting timesheet entries before submission to clients or employers. The AI-powered summarization feature uses third-party APIs (OpenAI and Claude); no git repository data is stored on external servers, but commit messages are transmitted to the AI provider for processing. Users should review their organization's data privacy policies before enabling AI features. The developers assume no liability for inaccurate timesheet data, missed deadlines, or billing disputes arising from the use of this software.


🤝 Contributing

We welcome contributions! See our CONTRIBUTING.md for guidelines.

PRs Welcome


Download

GitCommitFlow – Turn your commit history into professional timesheets. Save hours every week. Built for developers, by developers. 2026 Edition.

Ver o original no GitHub

Bom para

Relacionados