Claude AFK

Step away from your desk while Claude codes. Get notified on your phone when it needs you.

Get Started View on GitHub
📱

Push Notifications

Receive instant notifications on your phone when Claude Code requires input - no app required

🔒

Secure Pairing

Simple QR code pairing with secure device tokens and Web Push API

⚡

Lightweight

Fast and efficient CLI that starts instantly without slowing down your workflow

Perfect For

Get notified when Claude requests tool permissions or asks you a question

Running long builds or tests

Letting Claude refactor while you take a break

Working on multiple projects

Staying productive away from your desk

How It Works

1

Pair Your Device

Run the CLI setup command and scan the QR code with your phone

2

Grant Permissions

Enable push notifications when prompted in your browser

3

Install Hooks

Run a single command to automatically configure Claude Code hooks

4

Stay Notified

Get push notifications whenever Claude needs your attention

Responding to Notifications

When Claude Code requests permission, you can respond directly from your phone

👆

Tap to Allow

Tapping the notification body automatically sends "allow" to Claude Code, granting the requested permission

🔘

Action Buttons

Use the "Allow" action button for quick responses, or "Dismiss" to clear the notification without responding

⚠️ Web Notification Limitations

  • • Action buttons may not appear on all devices or browsers - some platforms only support basic notifications
  • • iOS requires adding this site to your home screen for notifications to work
  • • Notifications may be delayed by battery optimization settings on mobile devices
  • • The browser or PWA must remain installed - clearing browser data will break notifications

Quick Start

Prerequisite: Rust must be installed. Install Rust

# Install the CLI cargo install claude-afk
# Pair your device claude-afk pair
# Install Claude Code hooks claude-afk install-hooks
# Enable notifications claude-afk afk
# Disable notifications when you are back claude-afk back

Self-Hosting

Want to run your own backend? Claude AFK can be self-hosted using Docker.

View self-hosting guide

Platform Support

  • Android: Chrome, Firefox, Edge
  • iOS: Safari (add to home screen)
  • Desktop: All major browsers