Download and install Mains on your Mac in under a minute.
Download for Mac
Download
Head to mains.dev and click the Download for macOS button to get the latest .dmg file. Install the app
Open the downloaded .dmg file and drag Mains into your Applications folder.
Launch Mains
Open Mains from your Applications folder. On first launch, macOS may ask you to confirm since the app is downloaded from the internet — click Open to continue.
Mains is currently available for macOS only. Windows and Linux support is coming soon.
Prerequisites
Some features require additional tools to be installed on your system. You can use Mains without them, but the corresponding features won’t be available.
GitHub CLI (for GitHub features)
Mains uses the GitHub CLI (gh) for creating pull requests, managing issues, and other GitHub operations. Install it and authenticate:
brew install gh
gh auth login
Claude CLI (for Claude Code)
If you want to use Claude Code as your agent runtime in workspaces, you need the Claude CLI installed and authenticated.
If you already have Claude Code set up, you’re good to go. Otherwise, follow the Anthropic setup guide and run:
OpenAI Codex CLI (for Codex)
If you want to use OpenAI Codex as your agent runtime, install the Codex CLI and authenticate:
npm install -g @openai/codex
codex auth login
GitHub Copilot CLI (for Copilot)
If you want to use GitHub Copilot as your agent runtime, you need the GitHub CLI authenticated (see above), the Copilot CLI extension, and an active GitHub Copilot subscription.
Verify your Copilot access:
Cursor Agent CLI (for Cursor)
If you want to use Cursor as your agent runtime, install the Cursor Agent CLI and sign in with your Cursor account:
curl https://cursor.com/install -fsS | bash
