winget install --id=amanogawa01.TimeTraveler -e Time Traveler is a command-line tool that analyzes a Git repository's commit history and turns development activity into music. It maps repository statistics such as commit frequency, lines changed, file activity, and churn to musical properties including tempo, scale, intensity, note density, and dissonance, then synthesizes the result as audio.
Turn your Git history into music.
Time Traveler is a command-line tool that analyzes the history of a Git repository and transforms its development activity into a deterministic musical soundscape.
Instead of generating music with AI or randomly assigning notes, Time Traveler maps real repository data — commits, code changes, file activity, timestamps, and development patterns — directly to musical properties.
Time Traveler reads Git history and maps development activity to musical characteristics.
Repository-wide statistics influence the overall musical profile:
| Git data | Musical property |
|---|---|
| Commits per day | Tempo |
| Average lines changed | Intensity |
| Deletion/churn ratio | Dissonance and scale |
| Average files changed | Note density |
| Busiest commit hour | Root note |
| Code-change intensity | Waveform |
Individual commits influence the composition:
| Commit data | Musical property |
|---|---|
| Insertions and files changed | Scale degree |
| Deletion ratio | Harmonic tension |
| Files changed | Note duration |
| Commit size | Amplitude |
| Commit time | Octave |
| Time between commits | Event spacing |
Each musical commit produces five events:
The synthesizer then renders those events into stereo PCM audio and writes a WAV file.
Repositories with up to 1,000 commits are represented commit-by-commit.
For larger histories, Time Traveler automatically groups neighboring commits into chronological buckets. Each bucket combines the activity of the commits it represents.
This prevents extremely large repositories from producing millions of simultaneous music events while still representing the complete repository history.
Time Traveler has been stress-tested against repositories including:
npm i -g @summer_icicle/time-traveler
or, alternatively, you can install it from github and build it yourself.
Clone the repository:
git clone https://github.com/amanogawa01/time-traveler.git
cd time-traveler
Install dependencies:
npm install
Build the project:
npm run build
Link the CLI globally:
npm link
You can then use time-traveler from inside any Git repository.
Run:
time-traveler analyze
Example output:
Time Traveler
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Repository
Branch: main
Commits: 18
Age: 5.1 days
Code Activity
Lines added: 7,279
Lines deleted: 1,142
Total lines changed: 8,421
Files changed: 86
Churn ratio: 13.6%
Commit Activity
Commits/day: 3.50
Avg lines/commit: 467.8
Busiest hour: 3:00 PM
Musical Profile
Tempo: 85 BPM
Root note: G
Scale: major
Waveform: triangle
Intensity: 0.47
Dissonance: 0.14
Note density: 0.24
time-traveler export
The default filename contains the repository name, branch, and latest commit hash:
time-traveler-main-abcdef1.wav
Specify a custom filename with:
time-traveler export --output my-history.wav
or:
time-traveler export -o my-history.wav
time-traveler play
Time Traveler generates the composition and opens it using the operating system's default audio player.
All repository commands support a local branch with --branch or -b.
time-traveler analyze --branch develop
time-traveler export --branch develop
time-traveler play --branch develop
Run the CLI directly from TypeScript:
npm run dev -- analyze
Type-check the project:
npm run typecheck
Run the test suite:
npm test
Build:
npm run build
Time Traveler includes unit and integration coverage for:
The project is also manually stress-tested against very large real-world Git repositories.
GitHub Actions automatically runs type checking, tests, and the production build on pushes and pull requests.
Git Repository
│
▼
GitRepository
│
▼
GitHistoryParser
│
▼
GitCommit[]
│
├──────────────► GitHistoryAnalyzer
│ │
│ ▼
│ GitHistoryStats
│ │
│ ▼
│ MusicMapper
│ │
│ ▼
│ MusicProfile
│
▼
MusicComposer
│
▼
MusicEvent[]
│
▼
Synthesizer
│
▼
StereoBuffer
│
▼
WavEncoder
│
▼
WAV file
Time Traveler implements its own lightweight synthesis pipeline.
The generated soundscape uses:
Time Traveler is not intended to make Git history sound like a conventional song.
The goal is to create an audible representation of how a repository developed.
Two repositories with different development patterns should produce different musical profiles, while running Time Traveler repeatedly on the same history should produce the same composition.
The repository itself is the score.
Contributions are welcome. See CONTRIBUTING.md for guidelines.
Please also read the Code of Conduct and Security Policy.
Time Traveler is released under the MIT License. See LICENSE.