Install Pieces on macOS | Complete Setup Guide

Get started with Pieces on macOS – install via DMG, PKG, or Homebrew, then configure and optimize your setup for AI-powered development.

Install Pieces for macOS

Pieces for macOS is available via DMG (recommended), PKG, or Homebrew. All methods support both Apple Silicon and Intel Macs.

Disk image for Apple Silicon and Intel Macs. Package installer with guided setup. Install via the Homebrew package manager.

Requirements

macOS 13.0 (Ventura) or higher
Apple Silicon (M1/M2/M3/M4) or Intel processor

After installing, PiecesOS will request **Screen & System Audio Recording** and **Microphone** permissions to power features like Long-Term Memory. See [Granting macOS Permissions](/products/meet-pieces/troubleshooting/macos#macos-permissions) for a walkthrough.

Updating

Pieces automatically downloads and installs updates. When you check for updates from either the Desktop App or the PiecesOS Quick Menu, both apps update together.

From the Desktop App

Click your profile or username in the top-left corner of the Pieces Desktop App. Click `Check for Updates` in the dropdown menu. If an update is available, follow the on-screen prompt to install it, then restart when complete.

Profile menu in the Pieces Desktop App with Check for Updates

From the PiecesOS Quick Menu

Click the Pieces icon in your menu bar. Click `You're up to date` to trigger a check. If an update is available, follow the prompt to install.

PiecesOS Quick Menu showing your current version and update status

Pieces often downloads updates automatically and notifies you when a new version is ready. Use either method above to check manually.

Uninstalling

To quickly remove the applications, open Finder → Applications and drag both Pieces and PiecesOS to the Trash.

For a complete uninstall that removes all data, preferences, and caches, see the Complete Uninstall Guide.

Additional Resources

See the macOS troubleshooting guide or reach out to support for help.