GitHub Desktop Guide

Overview

GitHub Desktop is GitHub's official graphical Git client. It covers the full workflow from clone and commit to push and pull request management.

Core Features

1. Repository Management

• Clone: File → Clone Repository, enter URL or pick a GitHub repo
• Create: File → New Repository, choose a local path
• Switch: Dropdown menu in the top-left corner

2. Staging and Committing

GitHub Desktop detects file changes automatically:

1. Changed files appear in the left panel
2. Check files to stage (equivalent to git add)
3. Write a commit message
4. Click Commit to branch

Diff viewer: Click any file to see a line-level diff — green for additions, red for deletions.

3. Remote Sync

Fetch origin  → Get remote updates (no local changes)
Pull          → Fetch + merge remote changes
Push          → Send local commits to remote

The Fetch origin / Push / Pull buttons in the top-right correspond to different sync operations.

4. Branch Operations

• New branch: Branch → New Branch, or click the branch name
• Switch: Click the branch name to select
• Merge: Branch → Merge into Current Branch
• Create PR: Branch → Create Pull Request (opens in browser)

5. History View

Click the History tab to browse the branch's commit history, including:

• Commit message and timestamp
• List of changed files
• Per-file diff

Use Case Fit

Limitations

1. Unsupported complex operations:

   • Interactive rebase (CLI required)
   • Cherry-pick (CLI required)
   • Limited stash management

2. Basic CLI knowledge is still recommended for resolving merge conflicts

Continue Learning

1. ide/vscode-git — Git integration in VS Code
2. ide/jetbrains-git — Git integration in JetBrains IDEs
3. ide/terminal-git-ui — Terminal Git UI tools (lazygit / tig)