Skip to main content

Documentation Index

Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. Go to github.com and create or sign in to your personal account.
  2. Verify your email address and finish any required 2FA steps before the workshop.

Install And Sign In To GitHub Desktop

  1. Download GitHub Desktop.
  2. Install it on your Mac or Windows machine.
  3. 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.
  1. In your browser, open Prompthon-IO/agent-systems-handbook.
  2. Click Fork and create a fork under your own GitHub account.
  3. Wait until your fork is ready, for example https://github.com/<your-username>/agent-systems-handbook.

Clone Your Fork With GitHub Desktop

  1. In GitHub Desktop, open the File menu and choose Clone Repository.
  2. Use the GitHub.com tab to pick your fork, or the URL tab and paste your fork URL.
  3. Choose a local path such as ~/Projects/agent-systems-handbook or C:\Users\your-name\Projects\agent-systems-handbook.
  4. Click Clone.
  5. 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

  1. In Codex, choose the local folder you just cloned.
  2. Keep the session rooted at that repository.
  3. 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