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

# Install Agentastic on macOS

> Download and install Agentastic on your Mac using Homebrew or a manual DMG install. Covers system requirements and how to keep Agentastic up to date.

Agentastic is a native macOS application. You can install it in under a minute using Homebrew, or download the DMG directly from the Agentastic website and install it manually.

## System requirements

Before installing, confirm your Mac meets the minimum requirements.

| Requirement | Minimum                | Recommended     |
| ----------- | ---------------------- | --------------- |
| macOS       | 14.0 (Sonoma)          | 15.0+ (Sequoia) |
| Processor   | Intel or Apple Silicon | Apple Silicon   |
| RAM         | 4 GB                   | 8 GB+           |
| Disk space  | 200 MB                 | 500 MB+         |

## Install via Homebrew

Homebrew is the quickest way to install Agentastic and keep it up to date.

<Steps>
  <Step title="Run the install command">
    Open Terminal and run:

    ```bash theme={null}
    brew install agentasticai/tap/dev
    ```
  </Step>

  <Step title="Launch Agentastic">
    Once Homebrew finishes, open Agentastic from Spotlight or your Applications folder.
  </Step>

  <Step title="Open a project">
    Press `Cmd+O`, or drag any folder onto the app window, to open your first project.
  </Step>
</Steps>

## Install manually (DMG)

If you prefer to install without Homebrew, download the DMG directly from [agentastic.dev/download](https://agentastic.dev/download).

<Steps>
  <Step title="Open the DMG file">
    Double-click the downloaded `.dmg` file to mount it.
  </Step>

  <Step title="Drag to Applications">
    Drag **Agentastic.app** into your **Applications** folder.
  </Step>

  <Step title="Launch Agentastic">
    Open Agentastic from your Applications folder or Spotlight.

    <Note>
      On first launch, macOS may ask you to confirm opening the app. Click **Open** to proceed.
    </Note>
  </Step>
</Steps>

## Verify your installation

After installing, confirm everything is working correctly:

1. Open Agentastic.
2. Press `Cmd+O` to open a folder.
3. Navigate to any project directory and select it.

If you see the Navigator panel on the left with your project files, the installation is complete.

## Keeping Agentastic up to date

Agentastic uses Sparkle to check for updates automatically. When a new version is available, you'll see an in-app prompt to install it.

To check for updates manually, go to **Agentastic > Check for Updates** in the menu bar.