extra-git/man/fork.txt

Common utility commands for Git repositories.

git-fork(1) -- Fork a repo on github

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 of a project on GitHub via command line.

  A personal access token is required for making the API call to create a fork in GitHub. API Documentation here

  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 

  If using multiple accounts, override the global value in the specific repo using git config git-extras.github-personal-access-token 

EXAMPLE

  Fork expect.js:

    $ git fork https://github.com/LearnBoost/expect.js

  or just:

    $ git fork LearnBoost/expect.js

  Then:

    $ .....

    $ cd expect.js && git remote -v

      origin          git@github.com:/expect.js (fetch)
      origin          git@github.com:/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 <>

REPORTING BUGS

<>

SEE ALSO

<>