changelog

# changelog

Generate changelog from git commits

## Installation

This is a CmdForge tool. Install it from the CmdForge registry:

```bash
cmdforge install changelog
```

## Description

Automatically generates a formatted changelog from your git commit history. Analyzes commit messages and organizes them into a readable changelog format suitable for release notes or documentation.

## Usage

```bash
# Generate changelog for commits since last week (default)
echo "" | changelog

# Generate changelog for commits since a specific date
echo "" | changelog --since "2026-01-01"

# Generate changelog for the last 30 days
echo "" | changelog --since "30 days ago"

# Generate changelog since last tag
echo "" | changelog --since "$(git describe --tags --abbrev=0)"
```

## Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--since` | `last week` | Time period for git log (e.g., "last week", "2026-01-01", "30 days ago") |

## How It Works

1. **Extract Git Log**: Retrieves git commit history since the specified date
2. **AI Analysis**: Analyzes commits using AI to categorize and format them into changelog sections (features, fixes, improvements, etc.)
3. **Format Output**: Produces a clean, markdown-formatted changelog ready for release notes

## Dependencies

None - works with any git repository.