Getting Started

Installation

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 .

Basic Usage

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

# 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

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

TUI Controls

KeyAction
q / EscQuit
mToggle view mode (Split/Single)
Tab / / lNext metric (single view)
Shift+Tab / / hPrevious metric (single view)
/ kScroll up
/ jScroll down

Repository Management

Add a repository

kodo add .
kodo add . --name my-project
kodo add /path/to/repo --name myrepo --branch develop

Remove a repository

kodo remove .
kodo remove my-project
kodo remove /path/to/repo

List repositories

kodo list
kodo list --json