Install Perch
Perch requires macOS 14 or later and a working Claude Code install.
Install from the disk image
Open it and drag Perch to your Applications folder. That is the whole install. Perch is signed with an Apple Developer ID and notarized by Apple, so there is no warning to click through.
Install from the terminal
Paste this line into your terminal.
curl -fsSL https://tryperch.dev/Perch.zip -o /tmp/Perch.zip && \ ditto -x -k /tmp/Perch.zip /Applications && open /Applications/Perch.app
It downloads Perch, installs it in your Applications folder, and opens it. The icon appears in the menu bar, at the top right. That is the whole install.
If you would rather read before you run it, the three steps are the ones on screen: curl downloads the file, ditto unpacks it into /Applications, and open launches it.
Verify the download
shasum -a 256 /tmp/Perch.zip
It has to print exactly this:
4b435e19857fddabe21437e50296b0efda3402921f31ac94c3dc55617eacc9b9
Uninstall
Drag Perch.app from your Applications folder to the Trash. The only thing left behind is the preferences file that holds your license key and your settings, at ~/Library/Preferences/com.siantek.perch.plist. Your Claude Code files are untouched: Perch never does more than read them.