Skip to main content
This guide walks you through downloading Verdent, completing platform-specific installation, and authenticating with your Verdent account.

​
Requirements

Before installing Verdent, ensure your system meets these prerequisites:

​
System Requirements

  • Operating System: macOS 11+ or Windows 10+ (64-bit)
  • Git: Version 2.20 or higher (Installation Guide)
    Verdent uses Git worktrees for workspace isolation. Your project folder does not need to be a Git repository, but some features require Git and Verdent may guide you to initialize a repo when needed.
  • Internet Connection: Active connection required for AI service communication
  • Disk Space: At least 2 GB free (more recommended for large repositories, worktrees, and caching)
See System Requirements for detailed compatibility information.

​
Download

Download Verdent from the official website: verdent.ai/download Select your operating system to download the appropriate installer.

​
macOS Installation

1

Download

Download the .dmg file from verdent.ai/download
2

Open DMG

Double-click the downloaded .dmg file to mount it
3

Install

Drag the Verdent icon to the Applications folder
4

Launch

Open Applications and double-click Verdent
5

Security Approval

If prompted, open System Settings (or System Preferences) → Privacy & Security / Security & Privacy and click Open Anyway
Supported macOS Versions:
  • macOS 11 (Big Sur) and later
  • Intel and Apple Silicon supported

​
Windows Installation

1

Download

Download the .exe installer from verdent.ai/download
2

Run Installer

Double-click the downloaded .exe file
3

UAC Prompt

Click Yes when prompted by User Account Control
4

Installation Options

Follow the installer prompts (some builds may not offer a custom installation directory)
5

Complete

Click Install and wait for completion
6

Launch

Click Finish to launch Verdent, or find it in Start Menu
Supported Windows Versions:
  • Windows 10
  • Windows 11
  • 64-bit only

​
Authentication & Setup

After installation, you’ll need to authenticate with your Verdent account to start using the application.

​
Initial Authentication

1

Launch Verdent

Open Verdent from Applications (macOS) or Start Menu (Windows). The welcome screen appears.
2

Sign In

Click Sign In. Your browser will open to the Verdent authentication page.
3

Browser Authentication

Sign in with your Verdent account credentials (email/password or OAuth providers like Google, GitHub, etc.).
4

Return to App

Return to Verdent once authentication completes. You’ll see the main interface.
5

Open Project

Choose Open Project to select a directory, or Recent Projects if returning.

​
Verifying Installation

Confirm your installation is working correctly with these simple checks:

​
Visual Verification

  1. Application Icon - Verdent appears in Applications (macOS) or Start Menu (Windows)
  2. Signed In - You can see your account status in the app after authentication (e.g., avatar/email)

​
Functional Verification

1

Open Project

Open a directory in Verdent.
2

Send Test Prompt

Try a simple request like “Explain what this project contains” in the input box.
3

Receive Response

Verdent should analyze your project and provide a response shortly.
Success Indicators:
  • Verdent launches without errors
  • Successfully authenticated account
  • Can send prompts and receive responses
Verdent requires an active internet connection for AI features. If prompts aren’t responding, verify your network connectivity and ensure your firewall allows outbound HTTPS to Verdent’s API endpoints.

​
Troubleshooting Installation

Problem: “Verdent cannot be opened because it is from an unidentified developer”Solution:
  1. Open System Settings (or System Preferences) → Privacy & Security / Security & Privacy
  2. Find the Verdent warning message
  3. Click Open Anyway
  4. Confirm by clicking Open

​
FAQs

Yes. Verdent and the VS Code extension are independent applications. You can use both, and they share the same credit pool and account.
Verdent checks for updates automatically on launch. When an update is available:
  1. A notification appears
  2. Click Update to download and install
  3. Restart the application
You can also check manually from the app menu (for example: Help → Check for Updates).
macOS: Drag Verdent from Applications to TrashWindows: Use Settings → Apps → Verdent → Uninstall or Control Panel → Programs and Features

​
Next Steps

Quick Start

Complete your first task

Interface Guide

Explore the Verdent interface