Use this page after the Windows or Mac setup page. The goal is to end with a
local handbook repo that Codex can open immediately.
Keep GitHub passwords, browser sessions, 2FA codes, and personal access
tokens out of screenshots and public notes.
Create Or Confirm Your GitHub Account
- Go to github.com and create or sign in to your
personal account.
- Verify your email address and finish any required 2FA steps before the
workshop.
Install And Sign In To GitHub Desktop
- Download GitHub Desktop.
- Install it on your Mac or Windows machine.
- Open GitHub Desktop and sign in to GitHub through the browser flow.
Fork The Handbook Repository
For this workshop, prefer a fork-first workflow even if you only plan to read
the repo today.
- In your browser, open
Prompthon-IO/agent-systems-handbook.
- Click
Fork and create a fork under your own GitHub account.
- Wait until your fork is ready, for example
https://github.com/<your-username>/agent-systems-handbook.
Clone Your Fork With GitHub Desktop
- In GitHub Desktop, open the
File menu and choose Clone Repository.
- Use the
GitHub.com tab to pick your fork, or the URL tab and paste your
fork URL.
- Choose a local path such as
~/Projects/agent-systems-handbook or
C:\Users\your-name\Projects\agent-systems-handbook.
- Click
Clone.
- After the clone finishes, use GitHub Desktop to open the repo in Finder or
File Explorer if you want to inspect the local files first.
Open The Clone In Codex
- In Codex, choose the local folder you just cloned.
- Keep the session rooted at that repository.
- Start with a scoped prompt such as:
Summarize the workshops directory before changing anything.Find all links pointing to the current Codex workshop route.
Workshop Preference
GitHub Desktop can also prompt you to fork a repository the first time you push
to a repo without write access. For this handbook workshop, fork first and then
clone the fork so the ownership boundary stays obvious from the start.
Reference
