claude-notify

Send Telegram notifications when local Claude Code sessions finish or need attention.

Updated Mar 15, 2020
One-click install
npx skills add https://github.com/GameDevFox/neko --skill claude-notify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-notify
Source: https://github.com/GameDevFox/neko/tree/main/claude/skills/claude-notify
Command: npx skills add https://github.com/GameDevFox/neko --skill claude-notify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code can run long tasks in the background, and you may miss the moment it finishes or needs attention.

Core Features & Use Cases

  • Telegram notifications from local Claude Code sessions: Sends a message to your configured chat so you don’t have to check logs manually.
  • Proactive “task complete” prompting: Works well when you are away, so you get a heads-up after an all-nighter, extended session, or long-running autonomous work ends.
  • Credential-based local messaging: Reads your token and chat ID from local files and requires no setup at runtime.

Quick Start

Use claude-notify with a message like "Done — build finished successfully" to send your Telegram notification.

Frequently Asked Questions about claude-notify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a Telegram notification when Claude Code finishes a long-running task?

You can get a Telegram notification by using a local tool that reads your pre-configured Telegram credentials from files and sends a message to your chat when a Claude Code session completes. It requires no runtime setup for local agents.

Can I send Telegram alerts from a local Claude Code session without runtime setup?

Yes, you can send Telegram alerts from local sessions without runtime setup by reading your token and chat ID from pre-configured local files. The tool sends a short message directly to your configured chat.

What's the best way to monitor autonomous Claude Code background tasks remotely?

The best way to monitor autonomous background tasks is to configure credential-based local messaging that pings you on Telegram. This provides a proactive heads-up when extended sessions or all-nighters end.

Does Claude Code task completion notification work for remote agents?

No, this Telegram notification tool applies to local Claude Code sessions on the same machine. It does not provide additional setup for remote agents and relies on locally pre-configured credentials.

How do I prompt Claude Code to ping me when it is done working?

You can prompt Claude Code with explicit messages like "notify me when done" or "ping me" to trigger a Telegram alert. You can also include a custom message like "Done — build finished successfully" for your notification.

What Telegram credentials do I need to configure for Claude Code alerts?

You need to configure your Telegram bot token and chat ID in local files before using the notification tool. These credentials are read directly from the files to send alerts to your configured chat.