# Troubleshooting

## macOS says the app cannot be opened

The desktop app and binaries are **not signed with a paid Apple Developer ID**, so macOS
Gatekeeper may block the first launch ("cannot be opened" / "unidentified developer").

**Easiest fix** — install with the script, which strips the quarantine flag automatically:

```bash
curl -fsSL https://morphy.fyi/install-desktop.sh | bash
```

**Homebrew cask** — install, then clear the quarantine flag (see below):

```bash
brew install --cask deadraid/morphy/morphy-desktop
```

**Already installed the app another way?** Remove the quarantine flag manually:

```bash
xattr -dr com.apple.quarantine /Applications/Morphy.app
```

Or open **System Settings → Privacy & Security**, scroll to the message about Morphy, and
click **Open Anyway**.

## `morphy: command not found`

The install location isn't on your `PATH`. The CLI installer puts the binary in
`~/.local/bin`. Add it to your shell profile:

```bash
export PATH="$HOME/.local/bin:$PATH"
```

Then restart your terminal. If you installed via npm or Homebrew, make sure their global bin
directory is on `PATH`.

## Windows warns about an unknown publisher

The Windows app and CLI aren't code‑signed, so SmartScreen may warn. Click **More info →
Run anyway**, or install the CLI via `npm install -g @morphy-agent/cli`.

## "No provider configured" / authentication errors

- Run `/provider list` to see which account, model, and endpoint Morphy is actually using.
- Make sure the vault is unlocked: `/secrets status`, then `/secrets unlock <passphrase>`.
- Re‑save the key (`/provider set-key …`) or re‑run the browser login (`/provider login …`).
- Check that the matching `*_API_KEY` environment variable, if you use one, is exported in the
  shell that launched Morphy.

## Verifying a download

Every release ships `sha256sums.txt`. To check a file you downloaded manually:

```bash
sha256sum -c sha256sums.txt
```

(Use `shasum -a 256 -c sha256sums.txt` on macOS if `sha256sum` isn't available.)

## Still stuck?

Check the [latest release notes](https://github.com/deadraid/morphy-releases/releases/latest)
or the docs at [morphy.fyi](https://morphy.fyi).