Skip to main content
Verdent uses Git worktrees to create isolated workspaces. Git is a required dependency, but you don’t need to install it ahead of time.
On first launch, Verdent checks whether Git is available and compatible.
If Git is missing or outdated, Verdent will prompt you and guide you through installation.
This page provides manual installation options if you prefer to set it up yourself.

Why Verdent Uses Git

Verdent relies on Git worktrees to manage isolated workspaces safely:
FeatureWhat Git Enables
Workspace IsolationSeparate working directories via worktrees
Independent ChangesEach workspace can have its own branch and state
Git Workflow CompatibilityWorks with standard Git tools and workflows
Minimum Version: Git 2.20+
Recommended Version: Git 2.30+

macOS Installation


Windows Installation


Verifying Installation

After installation, verify Git is properly installed:
git --version
Expected output:
git version 2.39.0
Your version number may differ. Verdent requires Git 2.20+.

Upgrading Git

If your Git version is older than required, upgrade it:
# With Homebrew
brew upgrade git

Optional: Initial Configuration (for commits)

If you plan to create commits, Git may require an author name and email:
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
If you don’t commit changes, you may not need to set these values. Verdent or Git will prompt you when required.

FAQs

Git is a free, open-source version control system that tracks changes to your files. Verdent uses Git worktrees to create isolated workspaces.
No. Git worktrees are fundamental to Verdent’s workspace isolation. Without Git, Verdent cannot create or manage isolated workspaces.
Verdent can still work with folders that are not Git repositories. If Git initialization is required for workspace isolation, Verdent will prompt you and guide you through the next step.
Verdent requires Git 2.20+ for compatibility with worktree-based workflows. We recommend Git 2.30+ for smoother worktree operations.

See Also