Installation & Setup
Get Unified Dev running on your Mac in a few minutes. This guide covers downloading the app, connecting a VCS provider, and importing your first repositories.
1. Download
Go to unifieddev.app and download the build that matches your Mac:
- Apple Silicon — M1, M2, M3, M4 chips (most Macs from 2020 onwards)
- Intel Mac — older Intel-based MacBook and iMac models
The download is a .dmg file. Open it, drag Unified Dev into your Applications folder, and launch the app.
System requirement
macOS 13 Ventura or later is required. If you see a security warning on first launch, go to System Settings → Privacy & Security and click Open Anyway.
2. Connect a VCS Provider
Unified Dev connects to your repositories through VCS providers. On first launch you will be prompted to add a provider. GitHub is fully supported today; GitLab and Bitbucket are in active development.
GitHub via GitHub App
- Open Settings → VCS Providers
- Click Add provider and select GitHub
- Click Connect — your browser will open the GitHub App authorization page
- Authorize Unified Dev and grant access to the organizations or repositories you want to manage
- Return to the app — your GitHub account will appear as connected
GitLab / Bitbucket (personal access token)
- Open Settings → VCS Providers and click Add provider
- Select GitLab or Bitbucket
- Paste your personal access token into the token field
- Click Save provider
3. Add an Organization
Once a provider is connected, add the organizations whose repositories you want to track.
- Go to Organizations in the sidebar
- Click New Organization
- Enter the organization name and select the connected provider
- Click Save organization
4. Import Repositories
After adding an organization, import the repositories you want to work with.
- Select the organization from the sidebar
- Click Import repositories
- Check the repositories you want to track and click Import selected
Unified Dev will sync branches, pull requests, and issues in the background. You can also add a local repository directly via Add Repository in the Agents sidebar using a folder path.
5. Configure an AI Provider
AI agent features require at least one AI provider environment variable to be set. Unified Dev reads these from your shell environment automatically:
- Anthropic (Claude Code) — set
ANTHROPIC_API_KEY - OpenAI (Codex) — set
OPENAI_API_KEY - GitHub Copilot — sign in via Settings → Integrations
If no provider is detected, the chat input will display a notice. You can add environment variables in Settings → Agents → Environment Variables without modifying your shell profile.
6. Auto-updates
Unified Dev checks for updates automatically. When a new version is available, a prompt appears in the app header. Click Update to download and restart. You can also check manually via the About section in Settings.