> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mains.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

> How to install Mains on macOS

Download and install Mains on your Mac in under a minute.

## **Download for Mac**

<Steps>
  <Step title="Download">
    Head to [**<u>mains.dev</u>**](https://mains.dev) and click the **Download for macOS** button to get the latest `.dmg` file.
  </Step>

  <Step title="Install the app">
    Open the downloaded `.dmg` file and drag **Mains** into your **Applications** folder.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  Mains is currently available for macOS only. Windows and Linux support is coming soon.
</Note>

## **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
```

Verify your authentication:

```
gh auth status
```

### **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 [**<u>Anthropic setup guide</u>**](https://docs.anthropic.com/en/docs/claude-code) and run:

```text theme={null}
claude /login
```

### **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:

```
gh auth status
```

### **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
```

Run the CLI once so it can open a browser login flow:

```
agent
```

After authentication, Mains reuses those credentials for Cursor workspaces. See [**Cursor configuration**](/cursor/configuration) and the [**Cursor CLI overview**](https://docs.cursor.com/en/cli/overview) for details.