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.

  The `.dmg` is signed with a Developer ID Application certificate and
  notarized by Apple. The notarization ticket is stapled to the bundle,
  so Gatekeeper accepts it on first launch with no "unidentified
  developer" prompt.

## How do I install Paneflow with Homebrew? [#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? [#how-do-i-install-paneflow-from-a-dmg]

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

```bash
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:

```bash
open /Applications/Paneflow.app
```

  Intel Macs are not yet built in CI. If you are on a pre-2020 Mac, the
  Apple Silicon binary will fail to launch with an architecture error. A
  universal or Intel-only DMG ships in a future release; subscribe to
  [GitHub releases](https://github.com/ArthurDEV44/paneflow/releases) to
  get notified.

## How do I verify the installation? [#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:

```bash
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:

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

After the symlink lands, the standard verify command works:

```bash
paneflow --version
# paneflow 0.2.x
```

## What if macOS Gatekeeper blocks the app? [#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**:

```bash
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`.