GitHub Made Crystal Clear · chapter 2: Your first repository

Three doors, one repository

2026-09-04

Pick per task. Most working days use door two for the code and door three or one for everything GitHub adds on top.

Below: the paragraph from the book that builds this idea, then the diagram itself (Figure 2.1), and a recap. About a minute of reading.

There is more than one way to reach the same repository, and choosing badly is why some people find GitHub exhausting. The browser needs no install and is the right tool for a one-line fix or a first look. The git command line is the only one of the three that actually makes commits and moves history. The GitHub CLI, the gh command, is the newest door: "a command-line tool that brings pull requests, issues, GitHub Actions, and other GitHub features to your terminal." Figure 2.1 puts them side by side so you can pick per task rather than per personality.

Figure 2.1: Three doors, one repository. Pick per task. Most working days use door two for the code and door three or one for everything GitHub adds on top.
Figure 2.1: Three doors, one repository. Pick per task. Most working days use door two for the code and door three or one for everything GitHub adds on top.

Recap

  • The idea: Pick per task.
  • The picture: Figure 2.1, from chapter 2 ("Your first repository") of GitHub Made Crystal Clear.
  • Go deeper: the chapter builds this step by step, with recipes and sources at the end.

This diagram is one of many in GitHub Made Crystal Clear.

Every chapter opens with the gist, draws the hard ideas, and ends with recipes and sources.

Get the book

All diagrams