RepoBeats

Transform your git commits into music

RepoBeats analyzes your repository's commit history and generates unique musical compositions based on commit patterns, authors, timestamps, and code changes.

Quick Start

# Run in any git repository
npx repobeats ui

Installation

# Install globally
npm install -g repobeats

# Or use directly with npx
npx repobeats ui

Commands

repobeats ui

Start the interactive UI in your browser.

repobeats ui [path] [options]

Options:
  -p, --port <number>     Custom port (default: auto-detect)
  --host <address>        Host to bind (default: 127.0.0.1)
  --no-open               Don't open browser automatically
  --since <date>          Start from this date/commit
  --until <date>          End at this date/commit
  --max-commits <n>       Limit number of commits (default: 1000)
  --no-cache              Disable commit caching

repobeats export

Export your repository as MIDI, WAV, JSON, or a full bundle.

repobeats export [path] [options]

Options:
  -f, --format <type>     Output format: midi, wav, json, bundle (default: bundle)
  -o, --out <path>        Output file path
  --preset <name>         Use a preset: default, chill, intense, minimal, ambient
  --instruments <list>    Instruments for WAV: guitar,piano,drums,strings (comma-separated)
  --since <date>          Start from this date/commit
  --until <date>          End at this date/commit
  --max-commits <n>       Limit commits
  --anonymize             Remove author/message data

repobeats inspect

View repository statistics and mapping preview.

repobeats inspect [path] [options]

Options:
  --since <date>          Start from this date/commit
  --until <date>          End at this date/commit
  --max-commits <n>       Limit commits
  --json                  Output as JSON

Presets

| Preset | BPM | Scale | Character | |--------|-----|-------|-----------| | default | 120 | Pentatonic | Balanced, melodic | | chill | 70 | Major | Slow, soft, relaxing | | intense | 160 | Minor | Fast, aggressive | | minimal | 90 | Pentatonic | Clean, repetitive | | ambient | 60 | Dorian | Atmospheric, spacey |

How It Works

RepoBeats maps commit metadata to musical parameters:

| Parameter | Sources | |-----------|---------| | Pitch | Commit SHA, author name, hour of day, day of week | | Velocity | Lines added/deleted, files changed, message length | | Duration | Diff size, file count, message length | | Tempo | Fixed BPM or commit frequency |

UI Features

• Dashboard: Repository overview, commit heatmap, author stats
• Mapping: Customize how commits become notes
• Playback: Listen to your repo with real-time visualization
• Export: Download WAV, MIDI, JSON, or bundled archives

Examples

# Open current directory
repobeats ui

# Open specific repository
repobeats ui ~/projects/my-app

# Export last 100 commits as MIDI with chill preset
repobeats export --max-commits 100 --preset chill --format midi

# Export as WAV with piano and strings only
repobeats export --format wav --instruments piano,strings --preset ambient

# Export as WAV with all instruments
repobeats export --format wav --preset default

# Inspect with JSON output
repobeats inspect --json > stats.json

# Export anonymized bundle
repobeats export --anonymize --out my-project.zip

Requirements

• Node.js 18+
• Git repository with at least one commit

License

Proprietary - See LICENSE for details.

You may use this software for personal and educational purposes. Redistribution is not permitted.