Push notifications

Claude Code notifications on your iPhone

Stop checking the terminal. Agentfy pushes a notification the moment a Claude Code agent needs permission, finishes a task, or hits an error.

Quick answer

Agentfy sends Claude Code notifications to your iPhone using Claude Code's hooks: install the Agentfy plugin (or paste the one-line setup prompt on older Claude Code), and every agent state change fires a webhook that becomes an instant push notification — including what the agent is asking for, like a permission prompt. Setup takes under a minute and needs no CLI wrapper.

Permission-aware alerts

Notifications show the context — e.g. "Allow: npm test?" — so you can decide whether it's worth walking back to your desk without unlocking your phone.

Every state that matters

Get alerted when an agent starts working, pauses for permission, completes, or errors out. No more guessing whether it's still running.

Many agents, one stream

Running several Claude Code terminals? Each agent's notifications are labeled so you always know which session needs you.

Hooks-only, nothing relayed

Only hook events leave your machine — never your code or session output. There's no wrapper around the claude command and no daemon to keep alive.

How it works

  1. Download Agentfy and grab your account token.
  2. Install the Agentfy plugin (recommended): run "claude plugin marketplace add ibrillantes/claude-code-plugin", then "claude plugin install agentfy@agentfy --config api_token=<YOUR_TOKEN>", then "/reload-plugins". The plugin collects your token in a config dialog and stores it in your OS keychain, and adds an Agentfy webhook to your hooks — no CLI wrapper, no daemon. (On older Claude Code, paste the one-line setup prompt instead; it wires up the same hook.)
  3. Run Claude Code as usual. Status now lands on your iPhone in real time.

Frequently asked questions

How do I get Claude Code notifications on my iPhone?+
Install Agentfy, then install the Agentfy plugin in Claude Code: run "claude plugin marketplace add ibrillantes/claude-code-plugin" and "claude plugin install agentfy@agentfy --config api_token=<YOUR_TOKEN>", then "/reload-plugins". The plugin adds an Agentfy webhook to your Claude Code hooks, so every agent state change is pushed to your iPhone as a notification. On older Claude Code you can paste the one-line setup prompt instead. Either way it takes under a minute and you keep running the normal claude command.
Does Claude Code have built-in phone notifications?+
Claude Code has a hooks system that can run a command on events like finishing a turn or requesting permission, but it doesn't send phone notifications on its own. Agentfy plugs into those hooks and turns the events into iPhone push notifications, Live Activities, and Dynamic Island updates.
Why are my Claude Code notifications not arriving?+
Usually a hooks misconfiguration: a malformed settings.json, a hook on the wrong event, a silent/non-interactive shell, or iOS notification permissions turned off. Our troubleshooting guide walks through each cause and fix step by step.
Is it free?+
Yes — Agentfy's free tier includes 25 notifications per month. Pro unlocks unlimited notifications plus Live Activities.

Read more