> For the complete documentation index, see [llms.txt](https://antoinearnoud-2.gitbook.io/git-for-economists/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://antoinearnoud-2.gitbook.io/git-for-economists/using-remote-repository.md).

# Using Remote Repository

## Clone repository

Get the link to your repo on github and type

```bash
git clone link_to_your_repo_here
```

it will **create** a new folder with all the content of your remote repo.

## Create branches

To create a local branch that **tracks** a branch on the remote repo:

```bash
 git checkout -b LocalName origin/remotebranchname
```

To cancel all the change and start fresh from the remote point of the branch:

`git push origin HEAD --force`

To create an upstream branch (origin is the name of the remote repo, branch the name of the branch)

```bash
git push -u origin local-branch
git push --set-upstream-to remote/branch
```

Having an upstream branch registered for a local branch will:

* tell git to **show the relationship between the two branches in `git status` and `git branch -v`**.
* directs **`git pull`** ***without arguments***** to pull from the upstream when the new branch is checked out**.

To see all the current remote branch, type `git remote -v` . Best, use:

```
git fetch --all; git branch -vv
```

## Pull, Commit, Push

After work on the local files is done, commit:

```bash
git add files_to_add
git commit -m "commit comment here"
git push origin
```

Before working on anything new, make sure to pull any change from the central repository

```bash
git pull origin
```

You can also just check if there are any changes by fetching the information. This will not affect any file, just let you know if some files on the remote repository are different than the files on your local machine

```bash
git fecth --all
```

`git pull` is essentially a `git fetch` immediately followed by a `git merge`

## Commits

See the section on commits in the previous chapter.