kodo

A CLI tool for analyzing Git commit statistics with TUI visualization.

日本語

Features

• Analyze commit history with date range filtering
• Interactive TUI with bar and line charts
• Split view showing all metrics simultaneously
• Export data in JSON or CSV format
• Filter by branch and file extensions
• Daily, weekly, monthly, and yearly aggregation
• Multi-repository configuration support

Installation

mise (Recommended)

mise use -g github:yumazak/kodo

crates.io

cargo install kodo

From Releases

Download the appropriate binary for your platform from the Releases page.

From Source

cargo install --path .

Usage

# Analyze all configured repositories (last 7 days, TUI mode)
kodo

# TUI output with short option
kodo -o tui

# Analyze specific repositories by name
kodo --repo-name myproject,another-repo --days 7

# JSON output
kodo --output json --days 30

# CSV output
kodo --output csv --days 7

# Specify repository path
kodo --repo ~/projects/my-repo --days 14

# Filter by branch
kodo --branch main --days 7

# Filter by file extensions
kodo --ext rs,ts,js --days 7

# Weekly aggregation
kodo --period weekly --days 30

# DST-aware timezone aggregation (IANA timezone)
kodo --timezone America/New_York --days 30

# Single metric view (default is split view)
kodo --single-metric

TUI Controls

Configuration

Create a config file at ~/.config/kodo/config.json:

{
  "$schema": "https://raw.githubusercontent.com/yumazak/kodo/main/schemas/config.schema.json",
  "repositories": [
    {
      "name": "my-project",
      "path": "~/projects/my-project",
      "branch": "main"
    },
    {
      "name": "another-repo",
      "path": "~/work/another-repo"
    }
  ],
  "defaults": {
    "days": 7,
    "exclude_merges": true
  }
}

CLI Options

Metrics

• Commits: Number of commits
• Additions: Lines added
• Deletions: Lines deleted
• Net Lines: Additions - Deletions (can be negative)
• Files Changed: Number of files modified

Environment Variables

License

MIT License - see LICENSE for details.