Telegram Notifier

telegram-notifier

Skills • AI Agents • Two-Way Control Bridge • Remote Dev

Universal Telegram notification & interactive control bridge for AI coding agents: real-time alerts on your phone whenever tasks finish, human approvals with interactive buttons, plus two-way control to execute prompts, switch workspaces, and stop tasks directly from your smartphone!

Quick Start

Install and set up the skill across all your AI coding agents (Cursor, Claude Code, Antigravity, Windsurf) in one command:

The interactive setup wizard will run automatically to:

1. Connect your Telegram Bot Token and auto-detect your Chat ID.
2. Configure workspace folders for scanning recent projects (WORKSPACE_DIRS).
3. Set your preferred AI Agent CLI tool (gemini, claude, aider).
4. Auto-install and start the background daemon service (launchd on macOS, systemd on Linux, Startup on Windows).

How to Update

To update the skill to the latest version at any time:

Two-Way Interactive Bridge

With the interactive daemon running, your Telegram Bot becomes a full two-way command center:

Telegram Commands

Interactive Approval Buttons

When an AI Agent requests human feedback or approval, it sends interactive buttons directly to your Telegram chat:

- Approve / موافق
- Reject / رفض

Tapping the button immediately sends your decision back to the running process.

Background Daemon Service Management

The daemon can run in the foreground or as a persistent system background service:

Supported Operating Systems

- macOS: Configures a user launchd agent in ~/Library/LaunchAgents/com.telegram-notifier.daemon.plist
- Linux: Configures a user systemd unit in ~/.config/systemd/user/telegram-notifier.service
- Windows: Configures startup launcher in %APPDATA%\Microsoft\Windows\Start…