Skip to main content

Cloning and forking repositories from GitHub Desktop

You can use GitHub Desktop to clone and fork repositories that exist on GitHub.

About local repositories

Repositories on GitHub are remote repositories. You can clone or fork a repository with GitHub Desktop to create a local repository on your computer.

You can create a local copy of any repository on GitHub that you have access to by cloning the repository. If you own a repository or have write permissions, you can sync between the local and remote locations. For more information, see "Syncing your branch."

When you clone a repository, any changes you push to GitHub will affect the original repository. To make changes without affecting the original project, you can create a separate copy by forking the repository. You can create a pull request to propose that maintainers incorporate the changes in your fork into the original upstream repository. For more information, see "About forks."

When you try to use GitHub Desktop to clone a repository that you do not have write access to, GitHub Desktop will prompt you to create a fork automatically. You can choose to use your fork to contribute to the original upstream repository or to work independently on your own project. Any existing forks default to contributing changes to their upstream repositories. You can modify this choice at any time. For more information, see "Managing fork behavior".

You can also clone a repository directly from GitHub or GitHub Enterprise. For more information, see "Cloning a repository from GitHub to GitHub Desktop".

Cloning a repository

  1. En el menú File (Archivo) haz clic en Clone Repository (Clonar repositorio).

    Clonar opción de menú en la aplicación Mac

    Opción Clone menu (Clonar menú) en la app de Windows

  2. Haz clic en la pestaña que corresponde a la ubicación del repositorio que deseas clonar. También puedes hacer clic en URL para introducir manualmente la ubicación del repositorio.

    Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)

    Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)

  3. Elige dentro de la lista el repositorio que deseas clonar.

    Clonar una lista de repositorio

    Clonar una lista de repositorio

  4. Haz clic en Elegir... y navega a la ruta local en donde quieres clonar el repositorio.

    El botón Choose (Elegir)

    El botón Choose (Elegir)

  5. Haz clic en Clone.

    El botón Clone (Clonar)

    El botón Clone (Clonar)

Forking a repository

If you clone a repository that you do not have write access to, GitHub Desktop will create a fork. After creating or cloning a fork, GitHub Desktop will ask how you are planning to use the fork.

  1. En el menú File (Archivo) haz clic en Clone Repository (Clonar repositorio).

    Clonar opción de menú en la aplicación Mac

    Opción Clone menu (Clonar menú) en la app de Windows

  2. Haz clic en la pestaña que corresponde a la ubicación del repositorio que deseas clonar. También puedes hacer clic en URL para introducir manualmente la ubicación del repositorio.

    Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)

    Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)

  3. Elige dentro de la lista el repositorio que deseas clonar.

    Clonar una lista de repositorio

    Clonar una lista de repositorio

  4. Haz clic en Elegir... y navega a la ruta local en donde quieres clonar el repositorio.

    El botón Choose (Elegir)

    El botón Choose (Elegir)

  5. Haz clic en Clone.

    El botón Clone (Clonar)

    El botón Clone (Clonar)

  6. Si planeas utilizar esta bifurcación para contribuir con el repositorio ascendente original, haz clic Para contribuir con el proyecto.

    Opción del menú de contribuir con el proyecto padre

    Opción del menú de contribuir con el proyecto padre

  7. Si planeas utilizar esta bifurcación para un proyecto que no esta conectado ascendentemente, haz clic en Para mis propios propósitos.

    Opción de menú de contribuir con un proyecto independiente

    Opción de menú de contribuir con un proyecto independiente

  8. Haz clic en Continuar.

    El botón de continuar

    El botón de continuar

Managing fork behavior

You can change how a fork behaves with the upstream repository in GitHub Desktop.

  1. Abre el menú de Repositorio y luego haz clic en Ajustes de repositorio....

    Opción del menú de ajustes del repositorio en la app de Mac

    Opción del menú de ajustes del repositorio en la app de Windows

  2. Haz clic en Comportamiento de la bifurcación y luego selecciona la forma en la que quieres utilizarla.

    La opción de contribuir al repositorio padre en el menú de Comportamiento de la Bifurcación

    La opción de contribuir al repositorio padre en el menú de Comportamiento de la Bifurcación

  3. Haz clic en Save (guardar).

    El botón de guardar en el menú de Comportamiento de la Bifurcación

    El botón de guardar en el menú de Comportamiento de la Bifurcación

Creating an alias for a local repository

You can create an alias for a local repository to help differentiate between repositories of the same name in GitHub Desktop. Creating an alias does not affect the repository's name on GitHub. In the repositories list, aliases appear in italics.

  1. In the upper-left corner of GitHub Desktop, to the right of the current repository name, click .
  2. Right-click the repository you want to create an alias for, then click Create Alias.
  3. Type an alias for the repository.
  4. Click Create Alias.

Further reading