# Git Changelog

> Generate changelogs from git commits. Supports markdown, plain text, and JSON output with date ranges and tag-based filtering.

- Skill: `modbender/git-changelog-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/git-changelog-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/git-changelog-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/modbender/git-changelog-2

---


# Git Changelog

## When to use

Generate a human-readable changelog from git commit history. Works with any git repository.

## Setup

No dependencies required. Uses only git and bash.

## How to

### Basic changelog (last 30 days or since last tag)

```bash
bash scripts/changelog.sh --repo /path/to/repo
```

### Since a specific date

```bash
bash scripts/changelog.sh --repo /path/to/repo --since "2026-01-01"
```

### Date range

```bash
bash scripts/changelog.sh --repo /path/to/repo --since "2026-01-01" --until "2026-02-01"
```

### JSON output (for programmatic use)

```bash
bash scripts/changelog.sh --repo /path/to/repo --format json
```

### Plain text output

```bash
bash scripts/changelog.sh --repo /path/to/repo --format plain
```

## Output Formats

| Format | Description |
|--------|-------------|
| `markdown` | Default. Headers, commit hashes, authors, dates |
| `plain` | Simple bullet list |
| `json` | Array of commit objects with hash, subject, author, date, type |

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `--repo <path>` | Repository path | Current directory |
| `--since <date>` | Start date | Last tag or 30 days ago |
| `--until <date>` | End date | Now |
| `--format <fmt>` | Output format | markdown |
| `--group` | Group by conventional commit type | Off (needs bash 4+) |

## Notes

- Automatically detects the last git tag and uses it as the start point
- Excludes merge commits for cleaner output
- Conventional commit types (feat/fix/docs/etc) are extracted for JSON output
- `--group` mode requires bash 4+ (macOS ships with 3.2; install via `brew install bash`)