# Opening a Git Repository

One of the benefits of the Jujutsu version control system is it works well with git. If you are working on a project with other developers, you can use Jujutsu while everyone else uses git.

You have two options to open a git repository in Jjewel: clone a repository or create a new repository.

## Cloning a Repository

Clone a repository if you have a git repository on a service like GitHub, Gitlab, or Bitbucket.

Take the following steps to clone a repository:

1. Choose Repository > Clone.
2. Enter the location of the repository you want to clone.
3. Click the Clone button.
4. Choose a location to save the cloned repository on your Mac.
5. Click the Clone button.

The location for a GitHub repository takes the following form:

    https://github.com/GitHubAccount/RepoName.git

Where `GitHubAccount` is the name of the GitHub account that hosts the repository and `RepoName` is the name of the repository.

## Creating a New Repository

Create a new repository if you have a local git repository on your Mac.

In Jjewel press Cmd-Shift-N or choose File > New Repository to create a new repository. A Save panel opens for you to choose a location for your repository.

Navigate to the location where you want to create the repository folder. Enter the name for the repository in the Repository Name: text field. Click the Create Repository button to finish creating the repository.

### Moving the .jj Folder to the Correct Location

Suppose you have an existing project named `MyProject`. If you create a repository inside the `MyProject` folder, none of the files inside the `MyProject` folder will be tracked because those files are one level above the Jujutsu repository you created.

To track the files in the `MyProject` folder, you must move the Jujutsu repository inside the `MyProject` folder. Take the following steps to move the Jujutsu repository inside the `MyProject` folder:

1. Go to the Finder.
2. Press Cmd-Shift-Dot to show hidden files and folders. The Jujutsu repository is in a hidden folder.
3. Go to the `MyProject` folder in the Finder.
4. Open the folder you created for the repository.
5. Move the `.jj` folder to the `MyProject` folder.

There should be a `jj` folder and a `git` folder inside the `MyProject` folder.

Table of Contents