# Mac app (Pushary Isle)

Source: https://pushary.com/docs/agents/mac-app
Last updated: 2026-10-19

> Install Pushary Isle, the Mac app. See your agents' questions in the notch, answer with one key, and let the same question reach your phone when you step away.

Pushary Isle is the Pushary app for Mac. When an AI agent such as Claude Code, Codex or Cursor stops to ask you something, the question shows up in your Mac's notch. You answer with one key and the agent keeps going. When you step away, the same question reaches your phone instead.

It is included in every agent plan. See [pricing](/pricing) for the plans, or the [Mac app page](/mac-notch-app) for a quick look.

## What you need [#what-you-need]

* macOS 14 or later, on Apple silicon or Intel.
* A Pushary account. New accounts start with a 3-day free trial.
* No notch? That is fine. On a Mac without one, Isle sits at the top of the screen.

## Install [#install]

Download the app and drag it to Applications:

```text
https://github.com/Pushary/pushary-mac/releases/latest/download/Pushary.dmg
```

Or install it with Homebrew:

```bash
brew install --cask pushary/tap/pushary
```

Both give you the same signed and notarised app. It checks for updates on its own.

## First launch [#first-launch]

1. **Sign in.** Use your Pushary account, or create one.
2. **Start your trial.** Three days free, then $9.99 a month. You finish checkout in your browser. If your account already has a plan or a trial, this step is skipped.
3. **Connect your agents.** Isle finds the agents on your Mac and sets them up for you. You do not edit any config files. If Isle cannot set one up, it shows you one command to run.
4. **Pair your phone (optional).** Isle shows a code. Scan it with your phone's camera. If you do not have the Pushary phone app yet, the link takes you to the store. You can skip this and pair later in Settings, under **Account**.

## Agents it connects [#agents-it-connects]

Isle sets up these agents on its own:

* Claude Code
* Codex
* Cursor
* Gemini CLI
* Antigravity CLI
* VS Code
* OpenCode
* Qwen Code, CodeBuddy, Qoder, Droid and Devin CLI
* Hermes, when Hermes is already installed and the `hermes` command works
* fx

Other agents connected through Pushary, for example over [MCP](/docs/agents/connect-any-agent), also show up in the notch.

## Answer a question [#answer-a-question]

When an agent needs you, the notch opens on its own and shows the question, what the agent wants to run, and why. It stays closed if you are already looking at that agent's terminal.

A notch that opens on its own does not take the keyboard, so you keep typing where you were. These shortcuts work from any app:

| Shortcut | What it does                            |
| -------- | --------------------------------------- |
| `⌃⌘Y`    | Approve                                 |
| `⌃⌘N`    | Deny                                    |
| `⌃⌘P`    | Open the notch and give it the keyboard |
| `⌃⌘⎋`    | Close the notch                         |

You can change them in Settings, under **Shortcuts**.

Once the notch has the keyboard (click it, or press `⌃⌘P`), you can answer every kind of question:

| Question                  | How you answer                                                                       |
| ------------------------- | ------------------------------------------------------------------------------------ |
| Yes or no                 | `⌘Y` approves. `⌘N` denies.                                                          |
| Deny and explain          | Click **Deny with a reason** and type it. The agent reads your reason.               |
| Pick an option            | `⌘1` to `⌘9` picks the option with that number.                                      |
| Type a reply              | Type in the box and send.                                                            |
| Several questions at once | Answer each one, move between them with the arrow keys, then `⌘↩` sends all of them. |

<Callout type="info">
  Y or N on its own does nothing. Every key that answers a question needs ⌘, so typing in another app never answers a question by accident.
</Callout>

## See every session [#see-every-session]

Open the notch to see all your agent sessions in one list. Each row shows the project, what the agent is doing, and whether it needs you. The most urgent session sits at the top.

Need more detail before you answer? Open the session's terminal from the notch, and Isle brings that terminal to the front. To land on the exact tab, turn on **Jump to the Exact Terminal Tab** in Settings, under **General**. It works in Terminal and iTerm2, and in Ghostty 1.3 or later by project folder. macOS asks for Automation permission the first time.

## Step away from your Mac [#step-away-from-your-mac]

Isle and your phone share the same questions. Answer on one, and the question closes on the other.

Where approvals go is set by your approval mode. You can change it in the notch, under **Approvals**:

| Mode           | In the notch              | On your phone                                       |
| -------------- | ------------------------- | --------------------------------------------------- |
| **When away**  | The card shows here.      | Quiet while you are at this Mac.                    |
| **Always**     | The card shows here.      | Gets every approval too.                            |
| **Alert only** | No card opens on its own. | Gets an alert. You decide in the agent.             |
| **In agent**   | No card opens on its own. | No approval push. The agent asks in its own prompt. |

See [Policies](/docs/agents/policies) for what each mode does across all your devices.

<Callout type="warn">
  Agents that run on your Mac need your Mac awake and online. If you quit Isle, the agent asks Pushary directly. In **When away** and **Always**, the approval goes to your paired phone. With no phone paired, the agent asks in its own prompt. Cursor file edits have no prompt of their own, so keep Isle open if you rely on them.
</Callout>

## What it sends [#what-it-sends]

To show your sessions and keep your Mac and phone in sync, Pushary receives your agents' activity: the sessions, the tools they run, the project folder, and the start of your prompt as a task title. It also receives each question, the context around it, and your answer. That context can include a command, a file path, or text your agent wrote.

## Next steps [#next-steps]

<Cards>
  <Card title="Set your approval rules" description="Decide which actions run on their own and which ask you." href="/docs/agents/policies" />

  <Card title="Set up your phone" description="Get approvals on your lock screen when you step away from your Mac." href="/docs/agents/receiving-notifications" />

  <Card title="Fix a missing question" description="What to check when a question does not show up." href="/docs/agents/reference/troubleshooting" />
</Cards>