iOS Live Activities

Claude Code Live Activities

Watch your Claude Code agents from your lock screen. Live Activities keep real-time status pinned where you can glance at it — no unlocking, no app to open.

Quick answer

Agentfy uses iOS Live Activities to pin live Claude Code agent status to your iPhone lock screen. As an agent works, waits for permission, or finishes, the Live Activity updates in real time — the same mechanism iOS uses for sports scores and deliveries — so you can monitor a session without unlocking your phone or opening an app.

Real-time, glanceable status

A Live Activity stays on your lock screen and updates as the agent's state changes — working, needs you, done — so a glance is all it takes.

No app to open

Because it lives on the lock screen, you never have to unlock and dig into an app to check progress. The status comes to you.

Pairs with the Dynamic Island

On supported iPhones the same activity surfaces in the Dynamic Island, so status is visible even while you're using other apps.

Multi-agent aware

Track the agent you care about most right on the lock screen while the full dashboard keeps tabs on the rest.

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 Live Activities show Claude Code status?+
When you set up Agentfy, Claude Code's hooks fire a webhook on each state change. Agentfy receives it and updates a Live Activity — a live, system-managed card on your lock screen — so the agent's current status (working, needs permission, done, error) is always visible without opening an app.
Do I need a specific iPhone for Live Activities?+
Live Activities require iOS 16.1+, and Agentfy targets iOS 18+. The Dynamic Island presentation appears on iPhones that have a Dynamic Island; on other models the Live Activity still shows on the lock screen and in the notification area.
Is the Live Activity included for free?+
Live Activities are part of Agentfy Pro. The free tier includes 25 push notifications per month; Pro unlocks unlimited notifications plus Live Activities.

Read more