Import from Git

Importing an existing repo from Git can get you quickly up and running with Diversion. On the Enterprise plan, you can also enable bi-directional sync between your Git repo and Diversion, so that changes made in either place are reflected in the other. This is a great way to take Diversion for a test drive with no commitment.

Web UI
CLI

To import a repo using the Web UI, follow these steps:

Enable Diversion Sync

Go to the Diversion Sync GitHub App page and install the app. Before you start:

Install it on the GitHub account or organization that owns the repo, and give it access to that repo.
Sign in to Diversion with the account you will import with. When GitHub sends you back to Diversion, the app is linked to the account that is signed in. The email address does not matter.
Finish within 1 minute of installing. If you are not signed in yet, sign in first. After 1 minute the link fails.
One Diversion account can link to a GitHub account or organization. If a teammate already linked it, you cannot import from it with your account.

If the link fails, uninstall the app in your GitHub settings and install it again. After 3 failed attempts, your account cannot link the app. Contact us at support@diversion.dev.

Open the repo selector and choose 'Import Git repository'

Go to your Dashboard, open the repo selector dropdown (top-left), and choose Import Git repository from its footer (alongside Create new repository and Import from Perforce).

You'll be prompted to choose your import options

In the Import Git Repository dialog, choose whether you want to import your entire repo and keep all of its history, or just the latest commit from a specific branch:

Import only latest commit, then Default branch or Custom branch: followed by the branch name.
Import all branches with history. This gives you the option to Enable continuous bi-directional sync.

Note

Bi-directional sync is available on the Enterprise plan. To turn it on, contact us at support@diversion.dev.

Enter the url for the repo you want to import

Type it in the field whose placeholder reads Repository URL. For a repo that isn’t on GitHub, also select I confirm this repository does not use Git LFS, because Git LFS is supported only for GitHub repositories.

Click the 'Import' button

Wait for the import to complete

This happens in the background, and depending on the size of your Git repo can take a few minutes. You will receive an email when the import is complete.

To import a repo using the CLI, follow these steps:

Enable Diversion Sync

Go to the Diversion Sync GitHub App page and install the app. Before you start:

Install it on the GitHub account or organization that owns the repo, and give it access to that repo.
Sign in to Diversion with the account you will import with. When GitHub sends you back to Diversion, the app is linked to the account that is signed in. The email address does not matter.
Finish within 1 minute of installing. If you are not signed in yet, sign in first. After 1 minute the link fails.
One Diversion account can link to a GitHub account or organization. If a teammate already linked it, you cannot import from it with your account.

If the link fails, uninstall the app in your GitHub settings and install it again. After 3 failed attempts, your account cannot link the app. Contact us at support@diversion.dev.

Open a CLI terminal

Open your terminal of choice.

Using the Diversion Interactive Shell

If you want an interactive shell with nicer UI, open your terminal of choice and run the dv command. It works the same as your regular terminal, and you can use any of the dv commands (commit, init, etc…) directly without prefacing them with dv.

Import

Run the following command:

  dv import [git_url]

This will start importing your repo into Diversion with the default name - the same as the repo’s name in Git.There are several optional arguments for the import command. You can always run dv help import to see them in the terminal.

[repo-name]

Passing a repo name to the import command will save the repo to Diversion with that name, instead of the repo’s name in Git.

  dv import [git_url] [repo-name]

--with-sync

Enables bi-directional sync between your new Diverson repo and your Git repo. This means that any change you make to one repo will be reflected in the other.This is useful for testing Diversion or for keeping any Git-based pipelines you have in place.

  dv import [git_url] --with-sync

Note

Bi-directional sync is available on the Enterprise plan. To turn it on, contact us at support@diversion.dev.

--git-branch

By default, Diversion will import the latest commit from the default branch of your Git repo. If you want to import the latest commit from a different branch, you can use the --git-branch flag.

  dv import [git_url] --git-branch [branch-name]

--with-history

By default, Diversion will only import the latest commit from the default branch of your Git repo. If you want to import the entire repo with all of its history, you can use the --with-history flag.

  dv import [git_url] --with-history

Wait for the import to complete

This happens in the background, and depending on the size of your Git repo can take a few minutes. You will receive an email when the import is complete.

Get Started

AI

Collaborate

Work with Unreal Engine

Work with Unity

Integrations

Reference

CLI Reference

Changelog

Note

Using the Diversion Interactive Shell

Note