# Cloning with GitLab

In addition to being able to work with your projects on the IDE, you can also clone their repositories locally on your own machine with GitLab.

Once you set up your Snowflake DW or Conversion Project, click the "OPEN REPOSITORY" button. It will redirect to your project's GitLab repository. From there, you can choose to clone your repository either with SSH or HTTPS.

### With SSH

You can follow the instructions in the GitLab documentation to [Clone with SSH](https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html#clone-with-ssh) normally. Other actions such as pushing can be done with your SSH as well.

### With HTTPS

To clone with HTTPS, you must use a GitLab [Personal Access Token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).  Without it, your cloning attempt will result in a failed authentication error.

1. First, you need to [create a personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token) for your GitLab account. Be sure to remember it or store it somewhere safe.
2. Go to your project's repository page and select **Clone**. Then, copy the URL for **Clone with HTTPS**.
3. Open a terminal on the directory where you want to clone the project, and run the following command, replacing the URL with the one that you copied from your repository: \
   `git clone https://gitlab.com/sample-user/sample-https.git`
4. GitLab will prompt you for your username and password. You can input your username normally, but you *must* use your personal access token instead of your account's password, else your authentication will fail.
5. Your project will be cloned to your machine. Be sure to keep using your personal access token every time GitLab asks for your credentials.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/troubleshooting/cloning-with-gitlab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.