Install

The CLI is only available on macOS and Linux. Windows is not supported.

macOS
Linux

Install via Homebrew.

brew install mirurobotics/cli/miru

If you are not seeing the latest CLI version, refresh Homebrew with brew update.

The CLI is distributed to Linux as a Debian package. Other package formats are not yet supported.We recommend using apt to install the CLI. However, you can manually install the Debian package by downloading it from GitHub and installing it with dpkg.

APT
Manual

Set up

Set up Miru’s apt repository.

# ensure the appropriate dependencies are installed
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# add Miru's signing key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://packages.mirurobotics.com/apt/miru.gpg -o /tmp/miru.gpg.armor
sudo gpg --dearmor -o /etc/apt/keyrings/miru-archive-keyring.gpg /tmp/miru.gpg.armor
rm /tmp/miru.gpg.armor
sudo chmod a+r /etc/apt/keyrings/miru-archive-keyring.gpg

# add the repository to your sources list
sudo tee /etc/apt/sources.list.d/miru.sources > /dev/null <<EOF
Types: deb
URIs: https://packages.mirurobotics.com/apt
Suites: stable
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/miru-archive-keyring.gpg
EOF

Install

After configuring the apt repository, install the CLI.

sudo apt-get update
sudo apt-get install miru-cli

Install a specific version with sudo apt-get install miru-cli=<version> (e.g. 0.9.1, 0.10.0, etc.).

Download

All Miru CLI releases are available as Debian packages on GitHub. You can find the latest release here.To download the CLI, drop down the Assets section for the desired release. The assets ending with the .deb extension are the Debian packages for the Miru CLI.

Find the architecture that matches your target machine’s architecture and download the package.For example, if your robot is an x86_64 machine, you’ll want to download the miru-cli_<version>_amd64.deb package. If your robot is an aarch64 machine, you’ll want to download the miru-cli_<version>_arm64.deb package.

Install

After downloading the package, install it using dpkg.

sudo dpkg -i <...>.deb

Verify

To verify the CLI is installed and up to date, run the miru version command.

$ miru version
Version: 0.10.0
Commit: 76b320c4ecec7a8e4b12cabb635831a4ad1d5d28
Built: 2026-04-20T02:54:55Z

You can find the CLI release changelog in the CLI changelog.

Upgrade

To upgrade the Miru CLI to the latest version, run the upgrade command in your local machine’s terminal.

macOS
Linux

brew upgrade mirurobotics/cli/miru

If you are not seeing the latest CLI version, refresh Homebrew with brew update.

You can upgrade the CLI via apt or by manually downloading the package from GitHub. Since both methods use Debian packages, manual installations can be upgraded via apt and vice versa.

APT
Manual

sudo apt-get update
sudo apt-get install miru-cli

Upgrade to a specific version with sudo apt-get install miru-cli=<version> (e.g. 0.9.1, 0.10.0, etc.).

Uninstall

macOS
Linux

Remove via Homebrew.

brew uninstall miru

Remove the Debian package.

sudo apt-get purge miru-cli

If installed via apt, you can also remove the apt source.

sudo rm /etc/apt/sources.list.d/miru.sources 
sudo rm /etc/apt/keyrings/miru-archive-keyring.gpg
sudo rm /var/lib/apt/lists/packages.mirurobotics.com_apt_*
sudo apt-get update

The signing key at /etc/apt/keyrings/miru-archive-keyring.gpg is shared with the Miru Agent. Only remove it if you have also uninstalled the Miru Agent.

Remove any leftover configuration files.

rm -rf ~/.miru

Welcome

Primitives

Config Management

Data Uploads

Developers

Administration

Install

Install

Verify

Upgrade

Uninstall

​Install

​Verify

​Upgrade

​Uninstall

Install

Verify

Upgrade

Uninstall