DocsGet Started
View as Markdown

Installation

Install Agentastic, open a repository, and verify your first coding-agent connection

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 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

Agentastic detects known CLIs from your shell environment. See Supported Agents for all 40 built-in 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 or codex. Complete any first-run sign-in, then restart Agentastic so it can refresh your shell environment.

Install the dev CLI#

The app includes a system-wide dev CLI for launching and controlling agents from Terminal.app, another editor, a script, cron, or CI.

Open Agentastic → Install Shell 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#