Homebrew Installation

Install Pieces using Homebrew for a streamlined terminal-based setup. This method automatically installs both the Pieces Desktop App and PiecesOS.

Requirements

Homebrew: Ensure Homebrew is installed on your system. Visit brew.sh if you need to install it.
macOS 13.0 (Ventura) or higher

Install via Homebrew

Launch **Terminal** from Applications > Utilities, or use Spotlight (⌘ + Space) and search for "Terminal". Copy and run the following command:

```bash
brew install --cask pieces
```

If prompted, enter your administrator password to allow the installation. Homebrew will download and install both the Pieces Desktop App and PiecesOS. You'll see a success message when complete.

Updating via Homebrew

To update Pieces using Homebrew:

brew upgrade --cask pieces

Uninstalling via Homebrew

To remove Pieces using Homebrew:

brew uninstall --cask pieces

Next Steps

After installation, explore Conversational Search to start chatting with your memories, or configure Long-Term Memory to customize how Pieces captures your workflow context.

If you encounter issues, see macOS troubleshooting for common solutions.