Skip to content

research(tools): Claude Code Push Notification tool — mobile push on task completion #3329

@bug-ops

Description

@bug-ops

Description

Claude Code v2.1.110 introduced a Push Notification tool that allows Claude to send mobile push notifications when Remote Control is configured. The agent uses this to signal async task completion to a user who has left the session.

Pattern

When a long-running agentic task completes (or encounters an error requiring user input), the agent proactively calls the Push Notification tool with a short message. This integrates with Apple/FCM notification infrastructure via the Remote Control feature.

Relevance to Zeph

Zeph already has Telegram as a channel. A complementary mobile push approach would not require users to have Telegram configured. Options:

  1. Telegram notification (already have infra): post a short message to a configured Telegram bot when a CLI task completes
  2. macOS native notification (no server needed): call osascript from a PostToolUse or on-completion hook — works locally
  3. Pushover/ntfy.sh webhook (cross-platform, self-hostable): fire a webhook from completion hook

Lowest-effort path: add an optional [notifications] config section with a webhook URL; fire on task completion.

Source

Metadata

Metadata

Assignees

Labels

P3Research — medium-high complexityllmzeph-llm crate (Ollama, Claude)researchResearch-driven improvement

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions