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