> ## 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.

# Codex Workshop GitHub And Repository Setup

> Create or sign in to GitHub, install GitHub Desktop, fork the handbook, and clone your fork locally.

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

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.

<Warning>
  Keep GitHub passwords, browser sessions, 2FA codes, and personal access
  tokens out of screenshots and public notes.
</Warning>

## Create Or Confirm Your GitHub Account

1. Go to [github.com](https://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](https://desktop.github.com/).
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](https://github.com/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

* [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan)
* [GitHub Desktop setup docs](https://docs.github.com/en/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop)
* [Cloning and forking repositories from GitHub Desktop](https://docs.github.com/en/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)