<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Curtis-sama</title>
    <description>The latest articles on DEV Community by Curtis-sama (@curtis-sama).</description>
    <link>https://dev.to/curtis-sama</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4251786%2F3d440b69-6e59-44df-9c80-5cc9d2d33df7.jpg</url>
      <title>DEV Community: Curtis-sama</title>
      <link>https://dev.to/curtis-sama</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/curtis-sama"/>
    <language>en</language>
    <item>
      <title>I built Spotify Wrapped for your Git history (one command, zero dependencies)</title>
      <dc:creator>Curtis-sama</dc:creator>
      <pubDate>Wed, 18 Nov 2026 12:53:14 +0000</pubDate>
      <link>https://dev.to/curtis-sama/i-built-spotify-wrapped-for-your-git-history-one-command-zero-dependencies-4070</link>
      <guid>https://dev.to/curtis-sama/i-built-spotify-wrapped-for-your-git-history-one-command-zero-dependencies-4070</guid>
      <description>&lt;p&gt;Every December, my feed fills up with Spotify Wrapped screenshots. Top artists, minutes listened, "you're in the top 1% of fans"…&lt;/p&gt;

&lt;p&gt;And every December I think: &lt;strong&gt;I spent way more hours this year writing code than listening to music. Where's &lt;em&gt;that&lt;/em&gt; recap?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;So I built it.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx dev-wrapped
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run it in any Git repository and you get your year in code: in the terminal first, then as an animated story in your browser, Instagram-style, ending with a card you can share.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbvczjb38lh1h52c2k550.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbvczjb38lh1h52c2k550.gif" alt="The animated story" width="288" height="512"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What you get
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;A terminal recap.&lt;/strong&gt; Big gradient title, animated counters, a contribution heatmap of your year, a chart of the hours you code, your languages, and a few confessions pulled from your commit messages.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F44edbtpx20gwzax8b7ib.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F44edbtpx20gwzax8b7ib.png" alt="Terminal output" width="800" height="1133"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;An animated story in your browser.&lt;/strong&gt; Full-screen slides you tap through: your commits, your lines of code, your coding clock, your year at a glance, your languages, your favorite commit words.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A developer personality.&lt;/strong&gt; Based on &lt;em&gt;when&lt;/em&gt; and &lt;em&gt;how&lt;/em&gt; you commit, git-wrapped decides who you really are:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The Night Owl&lt;/strong&gt;: most of your code was written while the world was asleep&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Firefighter&lt;/strong&gt;: fixes, patches, hotfixes… you're the one everyone calls&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Cleaner&lt;/strong&gt;: you deleted more code than you wrote&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Sniper&lt;/strong&gt;: tiny, surgical commits&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Weekend Warrior&lt;/strong&gt;: you don't know what Saturday is&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;…and six more.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A share card.&lt;/strong&gt; A 1080×1350 image with your stats, ready for X, LinkedIn or your team's Slack.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the card looks like
&lt;/h2&gt;

&lt;p&gt;Here's an example card, generated from a demo repository:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fsj5swkhh8gs5f9swair0.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fsj5swkhh8gs5f9swair0.png" alt="Example Git Wrapped card" width="720" height="900"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Run it on your own repos and see what yours says about you. Fair warning: the "latest commit" stat can be humbling.&lt;/p&gt;

&lt;h2&gt;
  
  
  Three ways to run it
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx dev-wrapped                     &lt;span class="c"&gt;# the repo you're in (your commits)&lt;/span&gt;
npx dev-wrapped --scan ~/code       &lt;span class="c"&gt;# every repo on your machine&lt;/span&gt;
npx dev-wrapped --github            &lt;span class="c"&gt;# your whole GitHub account&lt;/span&gt;
npx dev-wrapped --github torvalds   &lt;span class="c"&gt;# yes, you can look up anyone&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;--github&lt;/code&gt; mode uses the GitHub API, so it also counts &lt;strong&gt;pull requests, reviews and issues&lt;/strong&gt;, and uses your exact profile contribution calendar. It needs a token: if you use the GitHub CLI it finds one automatically, otherwise set &lt;code&gt;GITHUB_TOKEN&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  How it works
&lt;/h2&gt;

&lt;p&gt;I set myself one rule: &lt;strong&gt;zero dependencies&lt;/strong&gt;. &lt;code&gt;npx&lt;/code&gt; should start instantly, and nobody should have to trust 200 transitive packages to look at their own commits.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Reading Git
&lt;/h3&gt;

&lt;p&gt;Everything comes from one &lt;code&gt;git log&lt;/code&gt; call:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git log --all --no-merges \
  --since=2026-01-01 --until=2027-01-01 \
  --date=format:&lt;span class="s1"&gt;'%Y-%m-%d %H %M %u'&lt;/span&gt; \
  --pretty=format:&lt;span class="s1"&gt;'%x1e%H%x1f%an%x1f%ae%x1f%ad%x1f%s'&lt;/span&gt; \
  --numstat
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A few details that matter:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;%x1e&lt;/code&gt; and &lt;code&gt;%x1f&lt;/code&gt;&lt;/strong&gt; are ASCII record and unit separators. Commit messages can contain any character a human can type, but nobody types those two, so splitting is safe.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;--date=format:&lt;/code&gt;&lt;/strong&gt; keeps the &lt;em&gt;author's&lt;/em&gt; local time. If you committed at 2am in Paris, it counts as 2am, not 1am UTC. That's what makes the Night Owl detection honest.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;--numstat&lt;/code&gt;&lt;/strong&gt; gives lines added and removed per file. Lockfiles (&lt;code&gt;package-lock.json&lt;/code&gt;, &lt;code&gt;yarn.lock&lt;/code&gt;, &lt;code&gt;Cargo.lock&lt;/code&gt;…) and &lt;code&gt;node_modules&lt;/code&gt;/&lt;code&gt;dist&lt;/code&gt; are ignored. Otherwise one &lt;code&gt;npm install&lt;/code&gt; would make you "The Architect".&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  2. Estimating hours of coding
&lt;/h3&gt;

&lt;p&gt;Git doesn't know how long you worked, but commit timestamps give a decent estimate. Sort all commits, then walk through them:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;if the gap to the previous commit is &lt;strong&gt;under 2 hours&lt;/strong&gt;, you were probably still working: add the gap;&lt;/li&gt;
&lt;li&gt;otherwise it's a &lt;strong&gt;new session&lt;/strong&gt;: add a flat 30 minutes for the work before its first commit.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="no"&gt;FIRST_COMMIT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;            &lt;span class="c1"&gt;// 30 min&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="n"&gt;times&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;gap&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;times&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;times&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="n"&gt;gap&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="no"&gt;TWO_HOURS&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="n"&gt;gap&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="no"&gt;FIRST_COMMIT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It's not perfect, but it's surprisingly close to what people guess when they see it.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Picking a personality
&lt;/h3&gt;

&lt;p&gt;Each personality is a score function. A score of 1 means "you qualify", and the highest score wins:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'The Night Owl'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;  &lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;nightShare&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;0.3&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;         &lt;span class="c1"&gt;// 30%+ commits between 22:00 and 05:00&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'The Firefighter'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;fixShare&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;0.3&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;          &lt;span class="c1"&gt;// 30%+ commits are fixes&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'The Marathoner'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;longestStreak&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;21&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="c1"&gt;// 3-week streak&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Nobody qualifies? You're &lt;strong&gt;The Steady Builder&lt;/strong&gt;. Adding a personality is about 10 lines, which makes it a great first contribution.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. A story in a single HTML file
&lt;/h3&gt;

&lt;p&gt;The browser story is one self-contained HTML file written to your temp folder: CSS, JavaScript, your stats as JSON, and the &lt;strong&gt;fonts embedded in base64&lt;/strong&gt; (Geist and Geist Mono). It looks identical on every machine and works offline.&lt;/p&gt;

&lt;p&gt;The icons are pure SVG path data. The same strings render as inline &lt;code&gt;&amp;lt;svg&amp;gt;&lt;/code&gt; in the slides &lt;em&gt;and&lt;/em&gt; as &lt;code&gt;Path2D&lt;/code&gt; objects on the &lt;code&gt;&amp;lt;canvas&amp;gt;&lt;/code&gt; that draws the share card:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="n"&gt;ctx&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stroke&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Path2D&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;ICONS&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;moon&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;One source of truth, two renderers.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. GitHub mode
&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;--github&lt;/code&gt; uses the GraphQL API. One query fetches the profile's &lt;code&gt;contributionsCollection&lt;/code&gt;: totals, the contribution calendar and the repos you committed to. Then, for your 40 most active repos, it pages through the commit history filtered by your user ID, a few repos in parallel. Timestamps come back in UTC, so they're converted to your time zone with &lt;code&gt;Intl.DateTimeFormat&lt;/code&gt; before the stats run.&lt;/p&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx dev-wrapped
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It's open source and MIT licensed: &lt;strong&gt;&lt;a href="https://github.com/Curtis-sama/dev-wrapped" rel="noopener noreferrer"&gt;github.com/Curtis-sama/dev-wrapped&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;If it made you smile, a ⭐ on GitHub helps a lot. And I'd love to know: &lt;strong&gt;which personality did you get, and is it accurate?&lt;/strong&gt; Drop it in the comments 👇&lt;/p&gt;

</description>
      <category>showdev</category>
      <category>opensource</category>
      <category>javascript</category>
      <category>git</category>
    </item>
  </channel>
</rss>
