---
title: Installation
description: "Install Agentastic for macOS, install the Agentastic agent CLI, verify your first connection, add the dev CLI, and set up automatic updates."
updated: "2026-10-01"
---

Agentastic runs on macOS 14 Sonoma or later, on both Apple Silicon and Intel Macs.

## Install the app

Choose either method. They install the same signed macOS application.

### Homebrew

```bash
brew install agentasticai/tap/dev
```

### Download the DMG

1. [Download the latest release](/download).
2. Open the `.dmg`.
3. Drag **Agentastic.dev** into **Applications**.
4. Open Agentastic from Applications or Spotlight.

On first launch, macOS may ask you to confirm that you want to open an app downloaded from the internet. Choose **Open**.

## Install the Agentastic CLI

Agentastic's own coding agent also runs standalone, without the desktop app, on macOS, Linux, and WSL. Pick one method.

### Install script (macOS, Linux, WSL)

```bash
curl -fsSL https://releases.agentastic.ai/agent/install.sh | sh
```

### Homebrew (macOS, Linux)

```bash
brew install agentasticai/tap/agentastic
```

### Beta channel

To follow the beta train instead, use either:

```bash
curl -fsSL https://releases.agentastic.ai/agent/install.sh | sh -s -- --channel beta
```

```bash
brew install agentasticai/tap/agentastic-beta
```

The script accepts `--version X` to pin a release, `--bin-dir DIR` to change where the binary goes, and `--no-modify-path` to skip shell startup edits.

### Requirements and setup

Requirements: x86_64 or arm64, with glibc 2.36 or later on Linux. The script installs under `~/.agentastic` (or `$AGENTASTIC_HOME`), puts `~/.agentastic/bin/agentastic` on your `PATH` via `.zshrc`/`.bashrc`/`.profile`, and verifies the release checksum.

Verify the install, then sign in and update:

```bash
agentastic --version
agentastic doctor
agentastic login
```

```bash
agentastic update        # script installs
brew upgrade agentastic  # Homebrew installs
```

Check `agentastic login status` any time to confirm your sign-in. The desktop app bundles the Agentastic CLI automatically (see [Agentastic Agent](/docs/features/agentastic-agent)), so skip this section if you already use the app.

## Install a coding agent

Agentastic orchestrates provider CLIs; it does not replace their subscriptions or credentials. Install at least one agent and sign in to it before launching your first task.

For example:

```bash
# Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# Codex
npm install -g @openai/codex

# Prime Agent
curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh
```

Agentastic detects known CLIs from your shell environment. Install and update actions in **Settings > Connections** use the shell selected in **Settings > Terminal**, then refresh executable detection as soon as the command finishes. See [Supported Agents](/agents) for all 55 public catalog definitions and their install commands.

## Verify the setup

1. Open Agentastic.
2. Press <kbd>Cmd</kbd>+<kbd>O</kbd> and choose a git repository.
3. Open **Agent Home**.
4. Confirm that your installed provider appears in the agent picker.

If the provider is missing, open a terminal and run its command directly—for example, `claude`, `codex`, or `prime-agent`. Complete any first-run sign-in, then restart Agentastic so it can refresh your shell environment.

## Install the dev CLI

The app includes a separate system-wide `dev` CLI for launching and controlling agents from Terminal.app, another editor, a script, cron, or CI. This is the app-control CLI, not the `agentastic` coding agent CLI above.

Open **Agentastic → Command Line Integration…** and follow the prompt. Then verify it from a regular terminal:

```bash
dev ping
dev instances
```

Read the [system-wide dev CLI reference](/docs/reference/dev-system) for agent, worktree, browser, and automation commands.

## Updates

Agentastic checks for signed updates through Sparkle. Use **Agentastic → Check for Updates…** whenever you want to check manually.

## Where next

- [Quick Start](/docs/quick-start) — learn the workspace in a few minutes
- [Your First Agent](/docs/your-first-agent) — launch, monitor, review, and clean up a task
- [Supported Providers](/docs/features/providers) — provider capabilities and install details
- [Common Issues](/docs/troubleshooting/common-issues) — PATH, permissions, git, and launch problems
