Claude Band Notifier
This project has two parts:
- Android bridge app: runs an HTTP server on the phone and sends Android notifications.
- Claude Code global hooks: work across all Claude Code projects and call the phone bridge.
Huawei Health syncs the Android notification to Huawei Band 10, which triggers vibration.
Install Global Hooks
Your Claude Code for VSCode environment does not support /plugin, so use global hooks.
Run once in PowerShell:
powershell -NoProfile -ExecutionPolicy Bypass -File D:\Desktop\app\band\tools\install-global-hooks.ps1
This writes hooks to:
C:\Users\Lenovo\.claude\settings.json
And writes the global phone config to:
C:\Users\Lenovo\.claude\band-notifier.config.json
This applies to every Claude Code project. You do not need to create band-notifier.config.json in new projects.
Change Phone IP
Edit:
C:\Users\Lenovo\.claude\band-notifier.config.json
Example:
{
"phoneUrl": "http://172.18.4.202:8765/notify",
"timeoutSeconds": 3,
"cooldownSeconds": 5,
"dryRun": false
}
Only change phoneUrl when the phone IP changes.
Android App
Open this project in Android Studio and run app on the phone.
The app shows a URL like:
Server URL: http://172.18.4.202:8765/notify
The HTTP server runs as a foreground service. Keep the persistent "Claude Band Notifier" notification enabled. On Huawei phones, also allow background activity or disable battery optimization for this app if notifications stop after the screen turns off.
Health check:
Invoke-RestMethod -Uri "http://172.18.4.202:8765/health"
Send a test notification:
Invoke-RestMethod `
-Uri "http://172.18.4.202:8765/notify" `
-Method Post `
-ContentType "application/json" `
-Body '{"agent":"claude_code","source":"vscode","event":"permission_request","title":"Claude Code","message":"Permission required","priority":"high"}'
Hook Events
| Hook | Meaning |
|---|
PermissionRequest | Claude Code needs permission |
Notification | Claude Code needs attention |
Stop | Claude Code response finished |
Logs
Check:
C:\Users\Lenovo\.claude\band-notifier\notify-band.log
If the log contains sent event=completed, the VSCode / Claude side is working.
Uninstall
powershell -NoProfile -ExecutionPolicy Bypass -File D:\Desktop\app\band\tools\uninstall-global-hooks.ps1
