Lock screen

Claude Code on your lock screen

Your agent's status, where you actually look. Agentfy puts live Claude Code status on the iPhone lock screen so a glance tells you everything.

Quick answer

Agentfy shows Claude Code agent status on your iPhone lock screen using Live Activities and notifications. Instead of unlocking and opening a terminal, you glance at the lock screen and instantly see whether an agent is working, waiting on a permission prompt, finished, or errored — updated in real time as the session changes.

Glance, don't unlock

The whole point: see what your agents are doing without unlocking your phone or hunting for an app. Status lives on the lock screen.

Real-time updates

As Claude Code moves through working → needs permission → done, the lock-screen Live Activity follows along instantly.

Notifications when you're away

Stepped away from your phone too? A push notification brings you back the moment an agent needs a decision.

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 see Claude Code on my lock screen?+
Install the Agentfy plugin in Claude Code (or paste its one-line setup prompt on older versions). From then on, a Live Activity shows your agent's live status on the iPhone lock screen, and notifications alert you when an agent needs permission or finishes — all without unlocking the phone or opening a terminal.
Does it keep updating in real time?+
Yes. Claude Code's hooks fire on each state change and Agentfy updates the lock-screen Live Activity right away, so the status you see is current — working, needs you, done, or errored.
What do I need for the lock-screen view?+
An iPhone on iOS 18+ and Agentfy Pro, which includes Live Activities. The free tier covers 25 push notifications per month if you just want alerts rather than the persistent lock-screen activity.

Read more