Skip to content

02b-setup-local.md

Latest commit

 

History

History
144 lines (92 loc) · 4.98 KB

02b-setup-local.md

File metadata and controls

144 lines (92 loc) · 4.98 KB
Raw

Adventure Local: Set Up Your Local Terminal

🧪 5-question terminal self-assessment

Check each statement:

  • I have opened a terminal before.
  • I can tell which folder I am in and change folders in a terminal.
  • I can copy, paste, and run multi-line commands.
  • I know how to read command output and spot errors.
  • I feel comfortable troubleshooting local install or proxy issues.

If any answer is No, switch to Set Up a Codespace for a faster setup with no local installs.

Important

Phones and tablets are not supported for this workshop. Switch to a desktop or laptop before continuing.

Working locally means you'll use the tools and shell you already know — let's get them ready in a few quick steps.

🎯 What You'll Do

You'll install Git and the gh CLI on your own machine and authenticate with GitHub. By the end you'll be ready to create your practice repository and continue to the core workshop steps.

📋 Before You Start

  • You've completed What You Need Before We Start
  • You have a free GitHub account and are signed in
  • You have a terminal application open (Terminal on macOS, Windows Terminal or Git Bash on Windows, any terminal on Linux)

Steps

Verify Git

git --version

Example success output after running git --version

What success looks like: a line like git version 2.x.x.

You should see git version 2.x.x or higher. If you see an error, download Git from git-scm.com and re-run the check.

Install the GitHub CLI

GitHub CLI is GitHub's official command-line tool, and you run it with the gh command. Check whether it's already installed:

gh --version

Example success output after running gh --version

What success looks like: version details for gh are printed.

If the command works, continue to the authentication section. If it does not, run the quick install command for macOS, Windows, or Linux.

macOS quick install

brew install gh
Don't have Homebrew?

If Homebrew is missing or blocked, use the macOS installer from cli.github.com. If Git was not found during Verify Git, install it from git-scm.com before continuing.

Windows quick install

winget install --id GitHub.cli
Don't have winget?

Linux quick install

sudo apt update && sudo apt install gh -y
Using a different package manager?
  • The quick install above is for Debian and Ubuntu.
  • For Fedora, Arch, or other package managers, use the Linux instructions at cli.github.com.
  • If Git was not found during Verify Git, install it with your distro package manager before continuing.

Run gh --version again after installing to confirm it worked.

If you're on GHES, GHEC, behind SSO, or behind a proxy, complete Side Quest: Enterprise Setup Considerations. If any install step is blocked by proxy, permissions, or host-specific setup issues, use Side Quest: Install gh-aw Troubleshooting.

Authenticate the gh CLI

gh auth login

Example prompt flow after running gh auth login

What success looks like: interactive prompts complete and login succeeds.

Choose GitHub.com and then Login with a web browser. A one-time code will appear in your terminal — copy it, open the URL shown, and paste the code when prompted.

Warning

Never share the one-time code or your authentication token with anyone. If you accidentally commit a token, revoke it immediately in Settings → Developer settings → Personal access tokens.

New repository

  1. Create your own public repository at github.com/new:
    • Name it my-agentic-workflows.
    • Check Add a README file.
    • Click Create repository.
  2. Clone the repository to your local machine:

Clone repository

gh repo clone my-agentic-workflows
cd my-agentic-workflows

✅ Checkpoint

  • I have cloned the my-agentic-workflows repository to my local machine
  • I have navigated into the my-agentic-workflows directory in my terminal
  • gh --version returns version 2.40.0 or newer

Next: GitHub Actions Intro