Installation

Mate runs on macOS, Windows, and Linux. Mobile apps for iOS and Android are available for remote access to a paired desktop.

System requirements

Platform	Minimum OS	Architecture
macOS	12.0 Monterey	Intel or Apple Silicon
Windows	10 (64-bit)	x86_64
Linux	Ubuntu 22.04 or equivalent	x86_64, ARM64
iOS	16.0	iPhone, iPad
Android	10 (API 29)	ARM64, x86_64

Download

Grab the latest release for your platform from GitHub:

Download Mate

All platforms — macOS .dmg, Windows .zip, Linux .tar.gz

Install by platform

Download the .dmg file from the releases page
Open the .dmg and drag Mate into your Applications folder
Launch Mate from Applications — if macOS shows a security warning, go to System Settings > Privacy & Security and click Open Anyway
Mate bundles its own Node.js runtime, so you do not need Node installed separately

Download the .zip file from the releases page
Extract the zip to a folder of your choice (e.g. C:\Program Files\Mate)
Run Mate.exe to launch
Node.js is bundled — no separate installation needed

Download the .tar.gz file from the releases page
Extract it: tar xzf mate-linux-*.tar.gz
Run the mate binary from the extracted folder
Node.js is bundled with the app

iOS and Android apps are available for pairing with a desktop running Mate. Mobile devices act as remote mirrors — they connect to your desktop over the local network and let you interact with your sessions from your phone or tablet.

Mobile devices do not run terminals or AI agents locally. They connect to a paired desktop that does the heavy lifting. See Pairing Devices for setup instructions.

Verify the installation

After launching Mate, you should see the workspace with a default terminal tab. Try typing a command to confirm everything works:

echo "Mate is ready"

If the terminal responds, you are good to go. Head to First Session to learn the basics.