Skip to main content
You’re working on a project. How exciting! What you want is a Diversion repository. Let’s get you set up:

Are you using Unreal?

You can do this with our Unreal Engine plugin!

​
Create a repository

1

Create a new repository

In the desktop app, click on the New repository button on the top right.Initialize a new repo
2

Choose a folder for the repo

You can create a new folder or use an existing one. If you have a game-engine project, you probably want to choose its root folder. For this example I’ll create a new folder, but the other steps work the same either way. I’ll select Create New Folderand call it CreatingNewRepo.Create a folder for the repo
3

Click Create

4

Syncing

A new repo is created in the folder you specified! The workspace’s Sync toggle shows it’s syncing, and its status reads Syncing… while it uploads the folder’s content to our cloud. In this example it’s an empty folder so it should only take a moment. If you create a new repo for an existing project, it might take a bit longer.Repo is still syncing
5

Good to go!

Once the upload finishes, the workspace row’s status changes to Synced. Open the repo and the workspace header names the commit your machine actually has — Synced to dv.commit.<id>. See Sync status for what each status means.Workspace header reading Synced to dv.commit.12345, cloud workspace dv.commit.12345, branch has no newer commits
And that’s it! You have a new repository. Anything you do in the directory will be tracked by Diversion. If there are files you don’t want tracked (e.g. build artifacts, temporary files), you can use a .dvignore file to exclude them.

​
AGENTS.md and CLAUDE.md

The Add AGENTS.md option in the Create New Repository dialog is on by default. It adds two files to the new repo’s first commit:
  • AGENTS.md has short instructions for coding agents: the main dv commands and safe habits.
  • CLAUDE.md is one line that tells Claude Code to read AGENTS.md.
AGENTS.md and CLAUDE.md in the files of a new repo Both files are optional. Diversion works the same without them, and you can edit or delete them like any other file.
  • To leave them out, uncheck Add AGENTS.md before you click Create.
  • Diversion never replaces an AGENTS.md or CLAUDE.md that is already in the folder.
  • dv init does not add them.

​
What’s next?