kodo 0.6.2

A CLI tool for analyzing Git commit statistics with TUI visualization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# CLI Reference

## Main Command

```bash
kodo [OPTIONS]
```

### Options

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `--config` | `-c` | Path to config file | `~/.config/kodo/config.json` |
| `--repo` | `-r` | Repository path | Current directory |
| `--days` | `-d` | Number of days to analyze | 7 |
| `--output` | `-o` | Output format (tui/json/csv) | tui |
| `--period` | `-p` | Aggregation period (daily/weekly/monthly/yearly) | daily |
| `--branch` | `-b` | Branch to analyze | Default branch |
| `--ext` | | File extensions to include (comma-separated) | All files |
| `--include-merges` | | Include merge commits | false |
| `--single-metric` | | Show single metric in TUI | false (split view) |
| `--repo-name` | | Filter repositories by name (comma-separated) | All repos |

## Subcommands

### `kodo add <path>`

Add a repository to the configuration.

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `<path>` | | Path to the repository (use `.` for current directory) | Required |
| `--name` | `-n` | Display name for the repository | Directory name |
| `--branch` | `-b` | Default branch to analyze | None |

**Examples:**

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

### `kodo remove <identifier>`

Remove a repository from the configuration.

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `<identifier>` | | Repository path or name to remove | Required |

**Examples:**

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

### `kodo list`

List registered repositories.

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `--json` | | Output in JSON format | false (table format) |

**Examples:**

```bash
kodo list
kodo list --json
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `KODO_CONFIG` | Path to config file |