gh-skyline

Generate a skyline STL file for the current year and authenticated user

$ gh skyline

$ gh skyline [[-u|--user]] [username] [[-y|--year]] [year]

$ gh skyline [[-u|--user]] [username] [[-y|--year]] [first_year]-[last_year]

$ gh skyline [[-u|--user]] [username] [[-f|--full]]

$ gh skyline [[-d|--debug]]

$ gh skyline [[-o|--output]] [path/to/output_file.stl]

$ gh skyline [[-u|--user]] [username] [[-w|--web]]

$ gh skyline [[-h|--help]]

gh skyline [--days <days>] [--theme <theme>] [--user <login>]

--days <days>
    Days of history to render (int, default: 365, max ~730)

--theme <theme>
    Visual style: blue, dark, gray, green, light, pink, purple (default: dark)

--user <login>
    Target GitHub username (default: authenticated user)

The gh skyline command, part of the GitHub CLI, creates an SVG image visualizing a user's GitHub contribution graph as a stylized city skyline. Each 'building' height corresponds to daily commit counts, echoing GitHub's annual Skyline feature but available year-round. Ideal for personal sites, portfolios, or READMEs to highlight coding activity.

Defaults to 365 days for the authenticated user in dark theme. Customize with --days for timeframe (1-730 typically), --theme for colors, and --user for others' profiles. Fetches data via GitHub API, respecting rate limits.

Output is SVG to stdout—redirect to save: gh skyline > profile.svg. Requires gh auth login and internet. Only public repos/contributions shown; private activity excluded. Themes enhance shareability across dark/light modes.

Public contributions only; redirect output (> file.svg).
API rate limits apply; auth required via gh auth login.
Days beyond ~2 years may lack data.

gh skyline --theme blue --days 180 --user torvalds > linux-skyline.svg
Saves Linus Torvalds' 180-day blue skyline.

Include SVG in Markdown/HTML: <img src="skyline.svg" alt="Contributions">
Resize with width/height attrs.

Added in GitHub CLI v0.11.0 (Sep 2020). Themes expanded in v1.x; full set by v2.0.0 (2022). Mirrors GitHub's 2016 Skyline experiment.

gh(1), git(1)