▪ tideline · v0.4.2

See your git history
like the tide.

A CLI that renders a repository’s commits as a tidal timeline — the rhythm of your codebase, surfaced in one glance.

curl -fsSL https://tideline.sh/install | sh
source on github
// 01 — live demo

One command. One chart.

tideline — ~/src/firestore-proxy — zsh — 80×22 first render 38ms

Authors:  █ margo   ▓ devon   ▒ priya   ░ samo   ▁ ci-bot  ·  amplitude = commits per tide-window

// 02 — why it earns its keep

A chart you can actually read.

Three things, each with a number you can verify on your own machine.

tidal, not tabular 01

Time on one axis. Activity as amplitude.

A spike reads “busy week” in under a second — no legend, no tooltip, no legend-for-the-legend. The shape of a release cadence, a merge-conflict ebb, or a stalled branch is visible before you read a single hash.

tideline --since=4w --by-author
reads any repo, instantly 02

Sub-100ms on 10k commits.

Zero config. Drop it in a checkout and run. It parses the .git directory directly — no index, no daemon. The Linux kernel (1.1M commits) renders in 3.8s.

tideline ./any-repo --depth=10k
pipes like unix 03

Output to SVG / JSON / terminal.

Compose with fzf, feed diff, or land it in a README. One flag changes the surface; nothing else changes. Stdin in, stdout out, exit 0.

tideline --format=svg > tide.svg
// 03 — the metaphor, earned

Fifty-two weeks.
One tide.

A real-shaped commit graph — 927 commits across 5 authors over a year. Every spike is a story. Hover a crest to read it. Point at a trough; you already know what happened.

repo: firestore-proxy w01 → w52
Tidal chart of 927 commits across 52 weeks for the firestore-proxy repository. Time runs left to right: oldest week on the left, the current week on the right. Peak activity is the release high tide near week 49.
  • Week 11: release-freeze surge, 27 commits, margo and devon.
  • Week 23: merge-conflict ebb, 10 commits.
  • Week 31: feature burst, 24 commits.
  • Week 41: summer trough, 2 commits.
  • Week 49: release high tide, 56 commits, the year's peak.
█ margo ▓ devon ▒ priya ░ samo ▁ ci-bot
MIT install size ~480 KB · zsh · bash · fish · works offline · single static binary · no telemetry
Built by people who write Makefiles for fun.
$ curl -fsSL tideline.sh/install | sh