GITPULSE
</gitpulse>
GITPULSE
Terminal CLI that turns any GitHub profile into a report card.
33
tests passing
5
hire-ability dimensions scored
0
browser dependencies
SPECIFICATIONS
| ROLE | SOLO BUILD |
|---|---|
| YEAR | 2025 |
| TYPE | CLI TOOL |
| STATUS | archive |
| STACK | typescript · node.js · cli · github-api · three.js · vitest |
| LINKS | [github ↗] |
| AVAILABILITY | in development |
“A GitHub profile is a wall of raw numbers with no judgment attached.”
A terminal CLI that generates beautiful developer profile report cards from any GitHub username.js 3D scene export.
README.TXT — GITPULSE (3 KB)[full readme →]
== WHAT IS THIS ==
A terminal CLI that generates beautiful developer profile report cards from any GitHub username. Stats, language breakdowns, contribution heatmaps, commit patterns, coding streaks, hire-ability scores, and Three.js 3D scene export.
== </the problem> ==
A GitHub profile is a wall of raw numbers with no judgment attached. Evaluating a developer means clicking through repos and mentally assembling the picture — and most visualization tools assume you have a browser to do it in.
== </my approach> ==
Built a TypeScript CLI targeting Node.js 18+ that pulls everything through the GitHub REST API behind a 30-minute cache and renders a full report card straight into the terminal with ANSI escape codes and Unicode box-drawing characters. A scoring engine grades hire-ability across 5 weighted dimensions, using Shannon entropy for language diversity and streak analysis for consistency.
== </the story> ==
GitPulse turns any GitHub username into a full developer report card in your terminal. Stats, color-coded language bars, contribution heatmaps, commit pattern sparklines, coding streaks, and a composite hire-ability score graded across 5 dimensions. Compare mode for head-to-head developer matchups. Three.js export for 3D visualization. 33 tests passing. Smart caching. Zero browser dependency.
== </architecture> ==
TypeScript targeting Node.js 18+. GitHub REST API with 30-minute cache layer. Scoring engine computes hire-ability across 5 weighted dimensions using Shannon entropy for language diversity and streak analysis for consistency. UI renders with ANSI escape codes and Unicode box-drawing characters.
== </key features> ==
Full terminal report card
Stats, color-coded language bars, contribution heatmaps, commit pattern sparklines, and coding streaks — all rendered natively in the terminal.
Opinionated hire-ability score
A composite grade across 5 weighted dimensions that makes actionable judgments rather than just echoing raw numbers.
Compare mode
Head-to-head developer matchups from any two GitHub usernames.
Three.js scene export
Export any profile to a 3D visualization scene.
Zero browser dependency
Works over SSH, in CI pipelines, and inside tmux. Nothing to render but text. 33 tests passing.
Smart caching
A 30-minute cache layer over the GitHub REST API keeps repeat runs fast and rate limits untouched.
== </key decisions> ==
DECISION 01
Terminal-native with zero browser dependency was deliberate - works over SSH, in CI pipelines, in tmux. The hire-ability score is intentionally opinionated, making actionable judgments rather than just showing raw numbers.
== </what i learned> ==
An opinionated score is more useful than a dashboard of raw numbers — making the tool commit to a judgment is what makes it actionable.
Terminal-native as a hard constraint is liberating. Zero browser dependency means the tool works everywhere a shell does, and ANSI plus Unicode box-drawing can carry surprisingly rich visualization.
typescript · node.js · cli · github-api · three.js · vitest
archive