Installation

Quick Install

The fastest way to install Squadron:


curl -fsSL https://raw.githubusercontent.com/mlund01/squadron/main/install.sh | bash

This auto-detects your platform, downloads the latest release, verifies the checksum, and installs to ~/.local/bin. To install a specific version:


curl -fsSL https://raw.githubusercontent.com/mlund01/squadron/main/install.sh | bash -s v0.0.43

You can override the install directory with INSTALL_DIR:


INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/mlund01/squadron/main/install.sh | bash

Manual Download

Download the latest release for your platform from GitHub Releases , extract it, and move the binary to your PATH:


# macOS (Apple Silicon)
curl -L https://github.com/mlund01/squadron/releases/latest/download/squadron_darwin_arm64.tar.gz | tar xz
sudo mv squadron /usr/local/bin/
 
# macOS (Intel)
curl -L https://github.com/mlund01/squadron/releases/latest/download/squadron_darwin_amd64.tar.gz | tar xz
sudo mv squadron /usr/local/bin/
 
# Linux (amd64)
curl -L https://github.com/mlund01/squadron/releases/latest/download/squadron_linux_amd64.tar.gz | tar xz
sudo mv squadron /usr/local/bin/
 
# Linux (arm64)
curl -L https://github.com/mlund01/squadron/releases/latest/download/squadron_linux_arm64.tar.gz | tar xz
sudo mv squadron /usr/local/bin/

Windows

Download the zip from GitHub Releases and extract it. In PowerShell:


# Download and extract
Invoke-WebRequest -Uri https://github.com/mlund01/squadron/releases/latest/download/squadron_windows_amd64.zip -OutFile squadron.zip
Expand-Archive squadron.zip -DestinationPath .
Remove-Item squadron.zip
 
# Move to a directory in your PATH
Move-Item squadron.exe C:\Windows\System32\

Upgrade


squadron upgrade

Or install a specific version:


squadron upgrade --version v0.0.28

Docker

Squadron publishes Docker images to GitHub Container Registry on every release:


# Alpine (default, small image)
docker pull ghcr.io/mlund01/squadron:latest
 
# Debian (for plugins that need glibc)
docker pull ghcr.io/mlund01/squadron:latest-debian

Run with your config mounted:


docker run -v ./my-project:/config -p 8080:8080 \
  ghcr.io/mlund01/squadron engage --cc

See the Docker guide for full setup details including Docker Compose.

Build from Source

Requires Go 1.25+.


git clone https://github.com/mlund01/squadron.git
cd squadron
go build -o squadron ./cmd/cli
sudo mv squadron /usr/local/bin/

Verify


squadron --help

Next Steps

Create a project directory and launch Squadron:


mkdir my-squadron && cd my-squadron
squadron engage --cc

On a fresh directory with an interactive terminal, engage runs the quickstart wizard, sets up your provider and API key, generates a starter mission, and opens the command center UI in your browser. See engage for the full walkthrough, or Quick Start for a guided overview.