# Install diversion with Homebrew Cask

Cloud-native version control CLI and agent. Version 1.6.177 via Homebrew Cask; verified 2026-09-17.

## Install

```sh
sudo av install cask:diversion
```

Additional install commands:

### macOS

- Homebrew Cask (100%):

```sh
brew install --cask diversion
```

  Evidence: local Homebrew cask metadata

## Package facts

- **Package key:** cask:diversion
- **Package manager:** Homebrew Cask
- **Package manager page:** <https://formulae.brew.sh/cask/diversion>
- **Version:** 1.6.177
- **Source summary:** Cloud-native version control CLI and agent
- **Homepage:** <https://www.diversion.dev/>
- **Upstream docs:** <https://www.diversion.dev/>
- **Source archive:** <https://get.diversion.dev/update/dv/v1.1.52/darwin-arm64.gz>
- **Last updated:** 2026-09-17T13:03:45Z
- **Generated:** 2026-09-19T06:45:57+00:00

## Executables

- darwin-arm64 (binary)
- dv (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: not available

## Freshness

- Page generated: 2026-09-19
- Package-manager version: 1.6.177
- Package-manager updated: 2026-09-17
- Local data: ok
- Upstream repository: https://www.diversion.dev/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Diversion is a cloud-native version-control platform and `dv` command-line client designed for large repositories containing code and binary creative assets.

### Project history

Diversion was founded to build source control around the needs of creative teams working with code, artwork, audio, and other large assets. The company describes the resulting system as cloud-native version control with no server infrastructure required from users.

The product family expanded beyond its command-line and desktop clients to include Unreal Engine and Unity integrations, repository mirroring, CI/CD support, APIs, and workflows for AI-assisted development.

### Adoption history

Diversion targets game development, virtual production, and other creative teams whose repositories combine source code with large binary assets. Official materials document integrations and workflows for Unreal Engine, Unity, CI/CD systems, and Git repository import.

Its positioning evolved from an alternative to Git and Perforce for game projects toward a collaboration platform for large repositories and parallel AI-agent workflows.

### How it is used

Users authenticate with `dv login`, create or clone a repository, and use commands such as `dv status`, `dv branch`, `dv checkout`, `dv commit`, `dv diff`, `dv log`, and `dv merge`. A background agent synchronizes workspace content with the hosted repository.

For automation, official CI/CD guidance uses an API token with `dv authenticate`, starts the agent in the background, clones into a new or existing workspace, and waits for `dv status` to confirm synchronization. The documentation recommends storing tokens in the CI platform's secure secret facility rather than a plain environment variable.

### Why package nerds care

Diversion is notable to package users as a proprietary, cloud-backed version-control system exposed through the `dv` CLI rather than a Git wrapper. It packages a centralized service, local agent, workspace synchronization, and familiar branch, commit, diff, merge, and log operations into a single client.

Its emphasis on large binary assets and automatically synchronized workspaces makes it relevant where Git LFS or self-hosted Perforce would otherwise add operational complexity.

### Timeline

- 2023: Official blog material documents Diversion's focus on next-generation version control for game developers.
- 2025: Official product updates document expanding review, webhook, Unreal, and asset-management workflows.
- 2026: Diversion presents the platform as infrastructure for large repositories and parallel AI-agent development.

### Related projects

- Git and GitHub repositories can be imported into Diversion, optionally with continuing synchronization.
- Perforce is a principal legacy alternative discussed in Diversion's official product material.
- Official integrations cover Unreal Engine and Unity.

### Sources

- <https://docs.diversion.dev/ci-cd>
- <https://docs.diversion.dev/cmd-ref/import>
- <https://www.diversion.dev/>
- <https://www.diversion.dev/about>
- <https://www.diversion.dev/blog>


## Security Notes

No matching local secret-handling manifest was found for diversion. Package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew cask API
- **Tap:** homebrew/cask
- **Full Token:** diversion
- **Names:** Diversion CLI
- **Depends On:** Macos: >=: 11
- **Artifacts:** Binary: 1, Target: 1, Uninstall: 1, Zap: 1
- **Deprecated:** no
- **Disabled:** no


## Related links

- [Homebrew Cask packages](https://pkg.so/homebrew-cask-packages/) - Generated from Homebrew Cask package-manager metadata.
- [Homebrew Cask binaries](https://pkg.so/homebrew-cask-binaries/) - Cask artifact metadata includes a binary.

## Combined YAML source

View the package source record on GitHub. [combined/diversion.yml](https://github.com/mxcl/pkgdb/blob/main/combined/diversion.yml)


## Sources

- pkg.so package database
- package-page enrichment
- curated package history
- package version freshness
- package relationship graph
- cross-ecosystem install command graph
