Linux in a Nutshell, 6th Edition

Name

remote

Synopsis

git remote add [-f] name repository-url
git remote rm name
git remote show name
git remote prune [--dry-run] name
git remote update [name ...]

Manipulate remotes, which act as short forms for tracking repository URLs and branches. This command takes one of several forms:

git remote add name repository-url

Register a new remote name at repository-url. With -f, also git fetch the set of remote branches from the new remote.

git remote rm name

Unregister the remote name.

git remote show name

Show information about the given remote name.

git remote prune name

Delete remote tracking branches that no longer exist on the remote name. To prevent accidental data loss, remote tracking branches in the local repository are never deleted unless you run this command.

git remote update [name ...]

Equivalent to running git fetch name for each of the names individually. If no names are provided, fetches all the registered remotes.

Examples

To show information about the remote named origin (which is created automatically by git clone):

$ git remote show origin
* remote origin
  URL: git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
  HEAD branch: master
  Remote branches:
    master     tracked
    production tracked
  Local branches configured for 'git pull':
    master     merges with remote master
    production merges with remote production
  Local refs configured for 'git push':
    master     pushes to master     (up to date)
    production pushes to production (local out of date)

To replace origin with a pointer to a ...