Installation
Step-by-step guide to installing and setting up Verdent
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). See Supported Operating Systems for full compatibility details.
- Git: Version 2.20 or higher. 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.
- macOS: Git ships with the Xcode Command Line Tools. Install with
xcode-select --install, or use Homebrew:brew install git. - Windows: Download the official installer from git-scm.com/download/win and accept the default options.
- Verify with
git --versionin a terminal.
- macOS: Git ships with the Xcode Command Line Tools. Install with
- Internet Connection: Active connection required for AI service communication
Optional but Recommended
- Disk Space: At least 2 GB free (more recommended for large repositories, worktrees, and caching)
Download
Download Verdent from the official website:
Select your operating system to download the appropriate installer.
macOS Installation
Download
Download the .dmg file from verdent.ai/download
Open DMG
Double-click the downloaded .dmg file to mount it
Install
Drag the Verdent icon to the Applications folder
Launch
Open Applications and double-click Verdent
Security Approval
If prompted, open System Settings → Privacy & Security (macOS 13+) or System Preferences → Security & Privacy (earlier macOS) and click Open Anyway
Supported macOS Versions:
- macOS 11 (Big Sur) and later
- Intel and Apple Silicon supported
Windows Installation
Download
Download the .exe installer from verdent.ai/download
Run Installer
Double-click the downloaded .exe file
UAC Prompt
Click Yes when prompted by User Account Control
Installation Options
Follow the installer prompts (some builds may not offer a custom installation directory)
Complete
Click Install and wait for completion
Launch
Click Finish to launch Verdent, or find it in the 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
Launch Verdent
Open Verdent from Applications (macOS) or Start Menu (Windows). The welcome screen appears.
Sign In
Click Sign In. Your browser will open to the Verdent authentication page.
Browser Authentication
Sign in with your Verdent account credentials (email/password or OAuth providers like Google, GitHub, etc.).
Return to App
Return to Verdent once authentication completes. You'll see the main interface.
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
- Application Icon - Verdent appears in Applications (macOS) or Start Menu (Windows)
- Signed In - You can see your account status in the app after authentication (e.g., avatar/email)
Functional Verification
Open Project
Open a directory in Verdent.
Send Test Prompt
Try a simple request like "Explain what this project contains" in the input box.
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:
- Open System Settings → Privacy & Security (macOS 13+) or System Preferences → Security & Privacy (earlier macOS)
- Find the Verdent warning message
- Click Open Anyway
- Confirm by clicking Open
Problem: Windows Defender blocks installation
Solution:
- Click More info on the SmartScreen popup
- If you downloaded Verdent from the official website and trust the source, click Run anyway
- Continue the installation
FAQs
Can I install Verdent alongside the VS Code extension?
Yes. Verdent and the VS Code extension are independent applications. You can use both, and they share the same credit pool and account.
How do I update Verdent?
Verdent checks for updates automatically on launch. When an update is available:
- A notification appears
- Click Update to download and install
- Restart the application
You can also check manually from the app menu (for example: Help → Check for Updates).
How do I uninstall Verdent?
macOS: Drag Verdent from Applications to Trash
Windows: Use Settings → Apps → Verdent → Uninstall or Control Panel → Programs and Features