Skip to content

handshek/gitfo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gitfo

A CLI tool to analyze git commits and show daily coding activity stats.

Features

  • Analyze commits in a single repository or scan multiple repositories to aggregate stats.
  • Show daily coding activity stats including commits, files changed, lines added/deleted, and net change.
  • Skip merge commits by default, and respects .gitignore.
  • Filter by specific date ranges (e.g., --today, --yesterday, --this-week, --since, --until).
  • Filter by author email.
  • Output formats available: table, json, and summary.
  • Fast, built with Bun and runs in a Node.js compatible environment.

Installation

# Install dependencies
bun install

# Build the project
bun run build

# Link globally to use the CLI
npm link # or bun link

Usage

# Analyze the current repository for today
gitfo

# Analyze past week
gitfo --this-week

# Analyze specific date range
gitfo --since 2026-01-01 --until 2026-01-31

# Filter by author
gitfo --author "user@example.com"

# Scan multiple repositories within a directory
gitfo --scan ~/projects

# Change output format
gitfo --format json
gitfo --format summary

Options

Option Description
--scan <paths...> Scan specific directories for git repositories
--date <date> Analyze a specific date
--since <date> Analyze from a specific date
--until <date> Analyze up to a specific date
--today Analyze today's commits
--yesterday Analyze yesterday's commits
--this-week Analyze this week's commits
--last-week Analyze last week's commits
--author <email> Filter by author email
--format <type> Output format (table, json, or summary)
--include-merges Include merge commits
-v, --verbose Verbose output

About

a small cli for getting git stats

Resources

Stars

Watchers

Forks

Contributors