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

# Configuration

## Config File Location

The default configuration file is located at `~/.config/kodo/config.json`.

You can specify a different path using:
- The `--config` option: `kodo --config /path/to/config.json`
- The `KODO_CONFIG` environment variable

## Config File Structure

```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
  }
}
```

## Repository Configuration

Each repository in the `repositories` array can have the following fields:

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Display name for the repository |
| `path` | string | Yes | Path to the repository (supports `~` expansion) |
| `branch` | string | No | Default branch to analyze |

## Default Settings

The `defaults` object configures default behavior:

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `days` | number | 7 | Number of days to analyze |
| `exclude_merges` | boolean | true | Exclude merge commits from analysis |

## JSON Schema

The config file supports JSON Schema validation. Add the `$schema` field to enable editor autocompletion and validation:

```json
{
  "$schema": "https://raw.githubusercontent.com/yumazak/kodo/main/schemas/config.schema.json"
}
```

## Managing Repositories

Instead of manually editing the config file, you can use CLI commands:

```bash
# Add a repository
kodo add /path/to/repo --name my-repo

# Remove a repository
kodo remove my-repo

# List all repositories
kodo list
```