aggregitor

Generate aggregated git commit logs from multiple git folders.

中文文档

Usage

# Create .aggregitor.yml in current directory
npx aggregitor init

# Collect and output aggregated git log
npx aggregitor

# Filter by date range (supports git-compatible date formats)
npx aggregitor --since "2024-01-01" --until "2024-12-31"
npx aggregitor --since "1 week ago"

# Verbose output
npx aggregitor --verbose

# Show version
npx aggregitor --version

CLI Options

| Option | Description | |--------|-------------| | --since <date> | Only include commits after this date (inclusive). Examples: "2024-01-01", "1 week ago", "2024-06-01 00:00:00" | | --until <date> | Only include commits before this date (inclusive). Same format as --since | | --verbose | Print detailed processing logs to stderr |

Configuration

All configuration is in .aggregitor.yml (single file, includes the Markdown template). See example for the full reference.

Output formats

• json — Fixed schema output (see example)
• md — Template-driven Markdown (default template built-in, or customize via output.template)

Template syntax

| Syntax | Description | |--------|-------------| | {{ variable }} | Interpolation | | {{ variable.nested }} | Nested property access | | {{#each list}}...{{/each}} | Loop over an array | | {{#if value}}...{{/if}} | Conditional | | {{#unless value}}...{{/unless}} | Inverse conditional | | {{! comment }} | Comment |