The GitHub Skyline CLI extension is now available!

[chrisreddington]

Hey everyone!

As we wrap up 2024, I’m excited to share some news with you! We’ve released gh-skyline, a GitHub CLI extension that allows you to render your contribution graph as an STL file for 3D printing!

If you used our former GitHub Skyline site, then this concept may be familiar to you! But we’ve sprinkled a few additional features into the CLI as well, including:

📅 Customizable year selection: Show off a single year or flex with multi-year masterpieces. See an example below!

🎨 ASCII art previews: See your contribution skyline in the terminal while your STL file is being generated

✨ And, it’s open source! Give it a star, and contribute with feature suggestions or pull requests at https://github.com/github/gh-skyline.

Want to get started? Make sure you have the GitHub CLI installed!

Once you have that installed and are logged in, you can install the extension with gh extension install github/gh-skyline

Here are a few example commands to get you started:

Generate a skyline:
gh skyline --year 2024

Generate a skyline for a specific user and year range:
gh skyline –-user chrisreddington --year 2014-2024

Don’t have a 3D printer? No problem! Did you know that you can upload STL files to a GitHub repository and they’ll render directly in your browser?

👀 We’d love to see your GitHub contribution history as a skyline! Drop a comment below with your render or 3D printed version, and let’s celebrate our contributions as a community!

[chrisreddington]

I'm excited to see everyone's contributions! I uploaded an STL file of my contributions since I've joined GitHub, and have definitely been a lot busier here over the last 4-5 years or so!

[martinwoodward]

I printed mine at 150% in a bronze filament on my Bambu X1C using 10% lightening infill - It show's my career at GitHub so far.

While seeing some of the peaks brings back memories of all the cool things I've gotten to do in that time, I'm also proud that you can definitely see gaps for most weekends. Also there is a big chunk where I took some time out this summer and it's very visible against my normally permanently online life.

[billythekid]

So happy to see the return of Skylines! I gifted a couple of 3D printed skylines from the old web version we had to friends as gifts and they loved them.

I particularly like how we can do a date range with this version, makes the cityscape vibe even better.

My stl

Time to get my pals accounts loaded in to the ranges for some updated, and timely, gifts... 🤠

[colbyfayock]

Good stuff. Printed it bit scaled down on my Bambu A1

[RodrigoMvs123]

Hi ! I just fineshed the gh skyline -user... command.
I already recieved a successfully message to: ser-21-24-github-skyline.stl.
Please ! How can I share my Github Skyline on my Github user acccount or Linkedin Profile ?

[chrisreddington]

Thanks for your interest in `gh-skyline1 @RodrigoMvs123! 🎉 Glad to see you have already used the extension in the CLI!

You would need to open the STL file in a 3D Model Viewing app, take a screenshot and then upload it. Alternatively, you could upload the STL file to a GitHub repository (even a private one!). When you view the STL file in the browser, it will be rendered in 3D. You can see an example in a repo of my own Skyline.

Hope that helps! ❤️

[chrisreddington]

PS @RodrigoMvs123 - @aidansteele pointed out that there was a typo in the command in the initial post. It should be --user instead of -user. In the filename you outputted, it looks like you have generated it for ser, instead of your own use, so please try that again.

Many thanks to @aidansteele for pointing that out!

[RodrigoMvs123]

@chrisreddington Ok ! And where do I find my STL file in the github CLI extension ?
Back on the -user I typed it wrong here in the chat but in the github CLI I did it right :)

[chrisreddington]

@RodrigoMvs123 It should be generated in the same directory that you executed the CLI command, hope that helps!

[foosel]

15 years of history 😬 And I'm more proud of the gaps than the peaks - they show I've learned to take breaks and recharge 💪

[kamermans]

Nice, thanks! Now I need to figure out which material to print it in :)

[rfinnie]

Does this work with GitHub Enterprise Server? I've tried gh auth switch to a GHES account, and also tried gh skyline while in the directory of a GHES repo, and both times it just picked a github.com account.

[chrisreddington]

Hey @rfinnie, thanks for the interest in gh-skyline! It's a great question, would you mind raising an issue over in the repository so that we can dig deeper into it? Thank you!

[aidansteele]

This looks great. Just FYI your example usage for a given user is probably misleading: it's missing a second hyphen in --user. The command as-is ends up generating an STL of activity for @ser. I can see (based on the filename) that at least one other user in this discussion has fallen victim to this typo.

[chrisreddington]

Excellent spot, thanks for pointing that out @aidansteele. I have corrected the post :)

[Chambras]

Could be a lot better that is for sure :)
but not as flat as I thought it would be ;)

[kamermans]

@chrisreddington, I want to print these as gifts for my developers, but it is unable to get the contribution graph for private contributions. This should be possible since they are in my organization, I'm an admin, and I can see their private contribution graph on their profile when I'm authenticated.

[kamermans]

Nevemind, I see this was already solved as an issue: github/gh-skyline#16 (comment)

TL;DR: you need to re-authenticate with the read:user scope:

gh auth login --scopes read:user

[FrenkenFlores]

Hi! for public organizations you can use gitprint.store and it's totally free. It can create a 3D model for a repo if you type-in for <org_name>/<repo_name>.