git-fork - Man Page
Fork a repo on github
Examples (TL;DR)
- Fork and clone a GitHub repository by its URL:
git fork https://github.com/tldr-pages/tldr
- Fork and clone a GitHub repository by its slug:
git fork tldr-pages/tldr
Synopsis
git-fork [<github-repo-url>]
Description
If a github repo url is given, fork the repo. Like clone but forks first.
- forks the repo on github
- clones the repo into the current dir
- adds the original repo as a remote called upstream
If a url is not given and the current dir is a github repo, fork the repo.
- forks the current repo
- rename the origin remote repo to upstream
- adds the forked repo as a remote called origin
Remotes will use ssh if you have it configured with GitHub, if not, https will be used. Create a fork a project on GitHub via command line.
A personal access token is required for making the API call to create a new fork in GitHub. API Documentation here https://docs.github.com/en/rest/reference/repos#forks
Make sure the personal access token has the right OAuth scopes for the repo(s)
Use git config --global --add git-extras.github-personal-access-token <your-personal-access-token>
If using multiple accounts, override the global value in the specific repo using git config git-extras.github-personal-access-token <other-acc-personal-access-token>
Example
Fork expect.js:
$ git fork https://github.com/LearnBoost/expect.js
or just:
$ git fork LearnBoost/expect.js
Then:
$ ..<forks into your github profile and clones repo locally to expect.js dir>... $ cd expect.js && git remote -v origin git@github.com:<user>/expect.js (fetch) origin git@github.com:<user>/expect.js (push) upstream git@github.com:LearnBoost/expect.js (fetch) upstream git@github.com:LearnBoost/expect.js (push)
If the current dir is a clone of expect.js, this has the same effect:
$ git fork
Author
Written by Andrew Griffiths <mail@andrewgriffithsonline.com>