---

name: diversion description: "Diversion (dv) cloud-native version control. When Claude needs to help with source control operations using Diversion including: initializing repositories, cloning, committing changes, branching, merging, viewing diffs and logs, or any other version control tasks. This skill covers all dv CLI commands."

Diversion Version Control

Overview

Diversion (dv) is a cloud-native version control system designed for modern development workflows. Unlike traditional VCS, Diversion provides real-time sync, simplified branching, and a web dashboard for collaboration.

Key Concepts:

• Repository: A cloud-hosted project containing all files and history
• Workspace: A local working copy synced with the cloud repository
• Branch: An isolated line of development
• Commit: A snapshot of changes with a message

Workflow Decision Tree

Starting a New Project

Use dv init to create a new repository from local files

Working on an Existing Project

Use dv clone to get a working copy of a repository

Making Changes

1. Edit files locally (changes sync automatically)
2. Check status with dv status
3. Commit with dv commit -m "message" -a

Branching Workflow

1. Create branch: dv branch -c feature-name
2. Work and commit on feature branch
3. Preview merge: dv merge-preview main
4. Merge: dv merge feature-name --into main

Updating Your Workspace

Use dv update to pull latest changes from the checked-out branch

Command Reference

Repository Commands

• init: Initialize a new repository
• clone: Clone a repository to local drive
• status: Show working tree and sync status
• repo: List or delete repositories

Workspace Commands

• workspace: List, pause, resume, rename, or delete workspaces
• checkout: Switch branches, commits, or tags
• preferences: Configure folder sync preferences
• view: Open workspace in web browser

Commit and Branch Commands

• commit: Create a commit
• branch: List, create, delete, or rename branches
• branch-name: Show current branch name
• log: Show commit history
• diff: Show differences between commits or workspace
• merge: Merge branches or commits
• merge-preview: Preview merge changes
• revert: Revert changes from a commit
• revert-to-commit: Revert workspace to a specific commit
• cherry-pick: Apply a specific commit
• restore: Restore file from commit, branch, or tag
• reset: Reset workspace changes
• clean: Remove untracked files
• tag: List, create, modify, or delete tags

Collaboration Commands

• share: Share workspace with users
• invite: Invite collaborators to repository
• update: Pull latest changes from branch

Navigation

• cd: Change working directory

Advanced Commands

• import: Import a git repository
• support: Create and upload support bundle
• unregister: Unregister local directory from sync

Utility Commands

• help: Print command usage
• login: Log into Diversion account
• authenticate: Authenticate with OAuth token
• logout: Log out of account
• feedback: Send feedback to developers

Common Workflows

Initialize and First Commit

Copydv init . my-project
# edit files
dv commit -m "Initial commit" -a

Clone and Start Working

Copydv clone my-project ./my-project
cd my-project
# edit files - changes sync automatically
dv status
dv commit -m "My changes" -a

Feature Branch Workflow

Copydv branch -c feature/new-feature
# make changes and commit
dv commit -m "Add new feature" -a
dv checkout main
dv merge feature/new-feature

View Changes Before Committing

Copydv status          # see changed files
dv diff            # see actual changes
dv diff path/file  # diff specific file

Reference Links

• Diversion Documentation
• Command Reference
• Discord Community