DocsGet Started
View as Markdown

Installation

Install Agentastic for macOS, install the Agentastic agent CLI, verify your first connection, add the dev CLI, and set up automatic updates.

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.
  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), 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 for all 55 public catalog definitions and their install commands.

Verify the setup#

  1. Open Agentastic.
  2. Press Cmd+O 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 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#