Install Paneflow on macOS

Paneflow runs on macOS 13 Ventura and later. Today the .dmg is the only macOS install path; a Homebrew tap is in the works. Apple Silicon is the supported architecture in v0.2.x; Intel builds land in a future release.

How do I install Paneflow with Homebrew?

A Homebrew tap is on the roadmap. Once it is published, this section will surface a one-liner you can paste. Until then, use the .dmg path below; it is the only supported macOS install at v0.2.x.

How do I install Paneflow from a .dmg?

Download the latest Apple Silicon .dmg, open it, and drag the app into Applications.

curl -LO https://github.com/ArthurDEV44/paneflow/releases/download/v0.2.16/paneflow-0.2.16-aarch64-apple-darwin.dmg
open paneflow-0.2.16-aarch64-apple-darwin.dmg

Finder mounts the disk image and opens a window with the Paneflow app and an Applications symlink. Drag Paneflow onto Applications, then eject the mounted volume.

Launch from Spotlight (Cmd+Space then "Paneflow") or directly:

open /Applications/Paneflow.app

How do I verify the installation?

Paneflow.app does not put paneflow on your PATH automatically - the binary lives at /Applications/Paneflow.app/Contents/MacOS/paneflow. The simplest verify is to launch the app from Spotlight (Cmd+Space then "Paneflow") or from the terminal:

open -a Paneflow

The title bar shows the running version on the first frame.

For CLI access from any terminal, symlink the binary into /usr/local/bin once:

sudo ln -sf /Applications/Paneflow.app/Contents/MacOS/paneflow /usr/local/bin/paneflow

After the symlink lands, the standard verify command works:

paneflow --version
# paneflow 0.2.x

What if macOS Gatekeeper blocks the app?

The notarized .dmg should never trigger the "Apple cannot check this app for malicious software" dialog. If you do see it, it means the quarantine attribute was preserved during an unusual transfer (e.g., downloaded via a non-Safari browser onto an external drive). Three ways to resolve, in order of friction:

Right-click Open (one-time per app):

1. Open Finder, navigate to Applications.
2. Control-click (or right-click) Paneflow.app.
3. Choose Open.
4. Click Open in the confirmation dialog.

Settings path (macOS 13+):

1. Open System Settings.
2. Go to Privacy & Security.
3. Scroll to the "Paneflow was blocked" notice.
4. Click Open Anyway.

CLI path:

xattr -d com.apple.quarantine /Applications/Paneflow.app

The xattr command removes the quarantine extended attribute so Gatekeeper stops blocking subsequent launches. No sudo required for apps you downloaded and dragged into /Applications yourself; an MDM-managed or root-installed app may need sudo.