/setup-github.en

description: "Lesson command"
duration: "~10 min"
prerequisites: ["/setup-start completed"]
level: "beginner"
tags: ["setup", "github"]
nonInteractiveMode: incompatible

GitHub Account Setup and Repository Creation

Step 0: Check Setup Progress

**What the AI auto-runs:** 1. Run `uv run python tools/setup_progress.py show --current setup-github` to display progress 2. Check if already logged in with `gh auth status`. If logged in, display "GitHub authentication is complete." 3. Check if a personal repo already exists with `git remote -v`. If it exists, confirm "Repository is also configured. Do you want to skip?"

What You'll Do in This Session

**Welcome to GitHub Account Setup!**

| Item | Details | |------|---------| | Goal | Log in to GitHub and create your own private repository | | Duration | ~10 minutes (15 minutes if account creation is needed) | | Skills Used | None (the AI handles everything automatically) | | Prerequisites | `/setup-start` completed (Python / Node.js / Git / GitHub CLI are installed) | | Next Command | `/start-0-1` (Environment setup check) |

**Session flow:** 1. Verify your GitHub account 2. GitHub authentication (just click "Allow" in the browser) 3. Create your personal repository

> **Important**: You don't need to type any commands in the terminal. The AI handles everything behind the scenes. When the browser opens, just follow the on-screen instructions. > **Security note**: Do not paste passwords or tokens in the chat. All authentication is done securely through the browser. > **Hint**: If the AI's response stops midway, type "please continue" or "it stopped" to resume. This is a Cursor behavior, not a bug. > > **Note for Codex**: In Codex, rather than running `/setup-github` directly, follow the verification steps in this document and proceed through `gh auth` sequentially. Only the browser login and authorization button clicks are done by the user.

---

Pre-session Confirmation

**AskQuestion configuration:**

{
  "title": "Pre-session confirmation",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "chrome", "label": "Automate browser operations with /chrome"},
      {"id": "check_prereq", "label": "I haven't done /setup-start yet"},
      {"id": "what_is_github", "label": "What is GitHub?"}
    ]
  }]
}

(ready -> Proceed to Step 1) (chrome -> When account creation is needed in Step 1, after opening the browser, follow the "Automating with Chrome integration" section for automatic execution) (check_prereq -> Guide: "Please run /setup-start first. It will check that the required software is installed.") (what_is_github -> Guide: "GitHub is a cloud service for safely storing and managing programs and files. Think of it as the programmer's version of Google Drive. In this training, we'll use it to save your work. It's free to use." -> Proceed to Step 1)

---

Step 1: Verify Your GitHub Account

**AskQuestion configuration:**

{
  "title": "Step 1: GitHub Account Verification",
  "questions": [{
    "id": "has_account",
    "prompt": "Do you have a GitHub account?",
    "options": [
      {"id": "yes", "label": "Yes, I have one"},
      {"id": "no", "label": "No (I want to create one)"},
      {"id": "not_sure", "label": "I'm not sure"}
    ]
  }]
}

If you have an account (yes)

-> Proceed to Step 2

If you don't have an account (no)

**What the AI auto-runs:** First, run `uname -s` to detect the OS (if already detected in Step 1, use that result).

Display:

Let's create a GitHub account.
The AI will open the browser automatically. Please wait a moment...

# AI runs:
# Mac:
open https://github.com/signup
# Windows:
start https://github.com/signup

**Account creation instructions:**

Once the browser opens, follow these steps:

1. Enter your email address and click "Continue"
2. Set a password and click "Continue"
   (Use a password with 8+ characters, including numbers or symbols)
3. Choose a username and click "Continue"
   (Only half-width alphanumeric characters and hyphens. Example: taro-yamada)
4. Choose your email notification preference and click "Continue"
5. Solve the puzzle verification and click "Create account"
6. A confirmation code will be sent to your registered email
7. Enter the 6-digit code from the email

Once account creation is complete, type "done" here.

Automating with Chrome Integration (`/chrome` mode, for new account creation only)

**Prerequisite:** The "Claude in Chrome" extension (v1.0.36+) must be installed in Chrome, and you must have launched with `claude --chrome` or run `/chrome` in the session.

**What the AI auto-runs with Chrome integration:** 1. Open https://github.com/signup in the browser 2. Use Chrome integration to perform the following operations in order:

• Focus on the email input field and prompt the user to enter their email
• Click "Continue"
• Click "Continue" after password entry
• Click "Continue" after username entry
• Click "Continue" after email notification settings
• Leave the puzzle verification to the user
• Click "Create account"

3. Email confirmation code entry is done manually by the user 4. After account creation is complete, proceed to Step 2

**Note:** Do not read password or email values from the browser screen.

If Chrome integration is not available, follow the steps above manually.

**AskQuestion configuration (completion check):**

{
  "title": "Account creation confirmation",
  "questions": [{
    "id": "account_created",
    "prompt": "Is the GitHub account creation complete?",
    "options": [
      {"id": "done", "label": "Done!"},
      {"id": "stuck", "label": "I got stuck partway"},
      {"id": "browser_not_open", "label": "The browser didn't open"}
    ]
  }]
}

(done -> Proceed to Step 2) (stuck -> "Which screen are you on? Please tell me what's d