ccpoke 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Claude Code Bot Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,158 @@
+# 🤖 ccpoke — Claude Code ↔ Telegram Notification Bot
+
+[Tiếng Việt](./README.md)
+
+> Get Telegram notifications when Claude Code completes a response — with git diff, processing time, and result summary.
+
+---
+
+## Problem
+
+You're using Claude Code on your computer. You step away with your phone but have no idea if Claude Code is done yet or what files it changed.
+
+**ccpoke** is a lightweight bridge between Claude Code and Telegram — when Claude Code finishes, you get a notification right on your phone.
+
+```
+Claude Code completes response
+        ↓
+  Stop Hook triggers
+        ↓
+  ccpoke receives event
+        ↓
+  Telegram notification 📱
+```
+
+## Features
+
+- 🔔 **Auto notification** — Claude Code finishes → Telegram notifies you instantly
+- 📂 **Git diff included** — see changed files without opening your computer
+- ⏱ **Processing time** — know how long Claude Code took
+- 📝 **Response summary** — quick glance at what Claude Code replied
+- 🔐 **User whitelist** — only authorized users can use the bot
+- 📄 **Auto-split messages** — long responses are automatically paginated `[1/N]`
+
+## Requirements
+
+- **Node.js** ≥ 18
+- **pnpm** (or npm/yarn)
+- **Telegram Bot Token** — create from [@BotFather](https://t.me/BotFather)
+- **Telegram User ID** — get from [@userinfobot](https://t.me/userinfobot)
+
+## Getting Started
+
+### Option 1: Global install (recommended)
+
+```bash
+pnpm add -g ccpoke
+ccpoke setup
+```
+
+### Option 2: npx (no install needed)
+
+```bash
+npx ccpoke setup
+```
+
+### Option 3: Clone repo (for development)
+
+```bash
+git clone https://github.com/palooza-kaida/ccpoke.git
+cd ccpoke
+pnpm install
+pnpm setup
+```
+
+The setup wizard will guide you step by step:
+
+```
+┌  🤖 ccpoke setup
+│
+◇  Telegram Bot Token
+│  your-bot-token
+│
+◇  Your Telegram User ID
+│  your-user-id
+│
+◆  Config saved
+◆  Hook installed → ~/.claude/settings.json
+◆  Chat ID registered
+│
+└  🎉 Setup complete!
+```
+
+<details>
+<summary>Manual setup (without wizard)</summary>
+
+Create `~/.ccpoke/config.json`:
+
+```json
+{
+  "telegram_bot_token": "123456:ABC-xxx",
+  "user_id": 123456789,
+  "hook_port": 9377
+}
+```
+
+Then run `ccpoke setup` to install the hook and register your chat ID.
+
+</details>
+
+## Usage
+
+### Start the bot
+
+```bash
+# Global install
+ccpoke
+
+# Or npx
+npx ccpoke
+
+# Or local dev
+pnpm dev
+```
+
+Once running, use Claude Code as usual → notifications will arrive on Telegram.
+
+### Telegram Commands
+
+| Command   | Description                                         |
+|-----------|-----------------------------------------------------|
+| `/start`  | Re-register chat (auto during setup, rarely needed) |
+| `/ping`   | Check if bot is alive                               |
+| `/status` | View bot status                                     |
+
+### Sample Notification
+
+```
+🤖 Claude Code Response
+📂 my-project | ⏱ 45s
+
+Fixed authentication bug in login.go. Main changes:
+- Fix missing error check at line 42
+- Add input validation...
+
+📂 Changes:
+✏️ src/login.go
+➕ src/validator.go
+❌ src/old_auth.go
+```
+
+## Uninstall
+
+```bash
+ccpoke uninstall
+```
+
+```
+┌  🗑️  Uninstalling ccpoke
+│
+◆  Hook removed from ~/.claude/settings.json
+◆  Removed ~/.ccpoke/ (config, state, hooks)
+│
+└  ccpoke uninstalled
+```
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,158 @@
+# 🤖 ccpoke — Claude Code ↔ Telegram Notification Bot
+
+[English](./README.en.md)
+
+> Nhận thông báo Telegram khi Claude Code hoàn thành response — kèm git diff, thời gian xử lý, và tóm tắt kết quả.
+
+---
+
+## Vấn đề giải quyết
+
+Bạn đang dùng Claude Code trên máy tính. Ra ngoài cầm điện thoại nhưng không biết Claude Code đã xong chưa, thay đổi file nào.
+
+**ccpoke** là cầu nối nhẹ giữa Claude Code và Telegram — khi Claude Code xong việc, bạn nhận notification ngay trên điện thoại.
+
+```
+Claude Code xong response
+        ↓
+  Stop Hook trigger
+        ↓
+  ccpoke nhận event
+        ↓
+  Telegram notification 📱
+```
+
+## Tính năng
+
+- 🔔 **Notification tự động** — Claude Code xong → Telegram nhận tin ngay
+- 📂 **Git diff kèm theo** — biết file nào thay đổi mà không cần mở máy tính
+- ⏱ **Thời gian xử lý** — biết Claude Code chạy bao lâu
+- 📝 **Tóm tắt response** — xem nhanh Claude Code trả lời gì
+- 🔐 **Whitelist user** — chỉ user được phép mới dùng được bot
+- 📄 **Auto-split message** — response dài tự động chia page `[1/N]`
+
+## Yêu cầu
+
+- **Node.js** ≥ 18
+- **pnpm** (hoặc npm/yarn)
+- **Telegram Bot Token** — tạo từ [@BotFather](https://t.me/BotFather)
+- **Telegram User ID** — lấy từ [@userinfobot](https://t.me/userinfobot)
+
+## Bắt đầu
+
+### Cách 1: Global install (khuyến nghị)
+
+```bash
+pnpm add -g ccpoke
+ccpoke setup
+```
+
+### Cách 2: npx (không cần cài)
+
+```bash
+npx ccpoke setup
+```
+
+### Cách 3: Clone repo (cho development)
+
+```bash
+git clone https://github.com/palooza-kaida/ccpoke.git
+cd ccpoke
+pnpm install
+pnpm setup
+```
+
+Setup wizard sẽ hướng dẫn từng bước:
+
+```
+┌  🤖 ccpoke setup
+│
+◇  Telegram Bot Token
+│  your-bot-token
+│
+◇  Your Telegram User ID
+│  your-user-id
+│
+◆  Config saved
+◆  Hook installed → ~/.claude/settings.json
+◆  Chat ID registered
+│
+└  🎉 Setup complete!
+```
+
+<details>
+<summary>Thiết lập thủ công (không dùng wizard)</summary>
+
+Tạo file `~/.ccpoke/config.json`:
+
+```json
+{
+  "telegram_bot_token": "123456:ABC-xxx",
+  "user_id": 123456789,
+  "hook_port": 9377
+}
+```
+
+Sau đó chạy `ccpoke setup` để cài hook và đăng ký chat ID.
+
+</details>
+
+## Sử dụng
+
+### Khởi động bot
+
+```bash
+# Global install
+ccpoke
+
+# Hoặc npx
+npx ccpoke
+
+# Hoặc local dev
+pnpm dev
+```
+
+Bot chạy xong → dùng Claude Code bình thường → notification tự đến Telegram.
+
+### Telegram Commands
+
+| Command   | Chức năng                                       |
+|-----------|---------------------------------------------------|
+| `/start`  | Đăng ký lại chat (tự động khi setup, ít khi cần) |
+| `/ping`   | Kiểm tra bot còn sống không                      |
+| `/status` | Xem trạng thái bot                               |
+
+### Notification mẫu
+
+```
+🤖 Claude Code Response
+📂 my-project | ⏱ 45s
+
+Đã sửa bug authentication trong login.go. Thay đổi chính:
+- Fix missing error check ở dòng 42
+- Thêm input validation...
+
+📂 Changes:
+✏️ src/login.go
+➕ src/validator.go
+❌ src/old_auth.go
+```
+
+## Gỡ cài đặt
+
+```bash
+ccpoke uninstall
+```
+
+```
+┌  🗑️  Uninstalling ccpoke
+│
+◆  Hook removed from ~/.claude/settings.json
+◆  Removed ~/.ccpoke/ (config, state, hooks)
+│
+└  ccpoke uninstalled
+```
+
+## License
+
+MIT

package/dist/channel/telegram/telegram-channel.d.ts

@@ -0,0 +1,18 @@
+import type { Config } from "../../config-manager.js";
+import type { NotificationChannel, NotificationData } from "../types.js";
+export declare class TelegramChannel implements NotificationChannel {
+    private bot;
+    private cfg;
+    private chatId;
+    private isDisconnected;
+    private tunnelUrl;
+    constructor(cfg: Config, tunnelUrl?: string | null);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    sendNotification(data: NotificationData, responseUrl?: string): Promise<void>;
+    private formatNotification;
+    private registerCommands;
+    private registerMenuButton;
+    private registerHandlers;
+    private registerPollingErrorHandler;
+}

package/dist/channel/telegram/telegram-channel.js

@@ -0,0 +1,148 @@
+import TelegramBot from "node-telegram-bot-api";
+import { ConfigManager } from "../../config-manager.js";
+import { sendTelegramMessage } from "./telegram-sender.js";
+import { MINI_APP_BASE_URL } from "../../utils/constants.js";
+import { t, getTranslations } from "../../i18n/index.js";
+import { log, logError } from "../../utils/log.js";
+export class TelegramChannel {
+    bot;
+    cfg;
+    chatId = null;
+    isDisconnected = false;
+    tunnelUrl;
+    constructor(cfg, tunnelUrl) {
+        this.cfg = cfg;
+        this.tunnelUrl = tunnelUrl ?? null;
+        this.bot = new TelegramBot(cfg.telegram_bot_token, { polling: false });
+        this.chatId = ConfigManager.loadChatState().chat_id;
+        this.registerHandlers();
+        this.registerPollingErrorHandler();
+    }
+    async initialize() {
+        this.bot.startPolling();
+        await this.registerCommands();
+        await this.registerMenuButton();
+        log(t("bot.telegramStarted"));
+    }
+    async shutdown() {
+        this.bot.stopPolling();
+    }
+    async sendNotification(data, responseUrl) {
+        if (!this.chatId) {
+            log(t("bot.noChatId"));
+            return;
+        }
+        const text = this.formatNotification(data);
+        try {
+            await sendTelegramMessage(this.bot, this.chatId, text, responseUrl);
+        }
+        catch (err) {
+            logError(t("bot.notificationFailed"), err);
+        }
+    }
+    formatNotification(data) {
+        const parts = [];
+        let header = `<b>${escapeHtml(data.projectName)}</b>`;
+        if (data.durationMs > 0) {
+            header += ` — ${escapeHtml(formatDuration(data.durationMs))}`;
+        }
+        parts.push(header);
+        if (data.inputTokens > 0 || data.outputTokens > 0) {
+            parts.push(`${t("notification.tokens")}: ${formatTokenCount(data.inputTokens)} → ${formatTokenCount(data.outputTokens)}`);
+        }
+        if (data.cacheReadTokens > 0 || data.cacheCreationTokens > 0) {
+            const cacheParts = [];
+            if (data.cacheReadTokens > 0)
+                cacheParts.push(`${formatTokenCount(data.cacheReadTokens)} ${t("notification.cacheRead")}`);
+            if (data.cacheCreationTokens > 0)
+                cacheParts.push(`${formatTokenCount(data.cacheCreationTokens)} ${t("notification.cacheWrite")}`);
+            parts.push(`${t("notification.cache")}: ${cacheParts.join(", ")}`);
+        }
+        return parts.join("\n");
+    }
+    async registerCommands() {
+        const translations = getTranslations();
+        const commands = [
+            { command: "start", description: translations.bot.commands.start },
+        ];
+        try {
+            await this.bot.setMyCommands(commands);
+            log(t("bot.commandsRegistered"));
+        }
+        catch (err) {
+            logError(t("bot.commandsRegisterFailed"), err);
+        }
+    }
+    async registerMenuButton() {
+        const url = this.tunnelUrl ? `${this.tunnelUrl}/` : `${MINI_APP_BASE_URL}/`;
+        try {
+            await this.bot.setChatMenuButton({
+                menu_button: JSON.stringify({
+                    type: "web_app",
+                    text: t("bot.open"),
+                    web_app: { url },
+                }),
+            });
+            log(t("bot.menuButtonRegistered"));
+        }
+        catch (err) {
+            logError(t("bot.menuButtonFailed"), err);
+        }
+    }
+    registerHandlers() {
+        this.bot.on("message", (msg) => {
+            if (!ConfigManager.isOwner(this.cfg, msg.from?.id ?? 0)) {
+                log(t("bot.unauthorizedUser", {
+                    userId: msg.from?.id ?? 0,
+                    username: msg.from?.username ?? "",
+                }));
+                return;
+            }
+            const text = msg.text ?? "";
+            if (text === "/start") {
+                if (this.chatId === msg.chat.id) {
+                    this.bot.sendMessage(msg.chat.id, t("bot.alreadyConnected"));
+                    return;
+                }
+                this.chatId = msg.chat.id;
+                ConfigManager.saveChatState({ chat_id: this.chatId });
+                log(t("bot.registeredChatId", { chatId: msg.chat.id }));
+                this.bot.sendMessage(msg.chat.id, t("bot.ready"), { parse_mode: "MarkdownV2" });
+                return;
+            }
+        });
+    }
+    registerPollingErrorHandler() {
+        this.bot.on("polling_error", () => {
+            if (!this.isDisconnected) {
+                this.isDisconnected = true;
+                log(t("bot.connectionLost"));
+            }
+        });
+        this.bot.on("polling", () => {
+            if (this.isDisconnected) {
+                this.isDisconnected = false;
+                log(t("bot.connectionRestored"));
+            }
+        });
+    }
+}
+function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function formatDuration(ms) {
+    const totalSeconds = Math.floor(ms / 1000);
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return `${minutes}m${seconds}s`;
+}
+function formatTokenCount(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(1)}M`;
+    if (tokens >= 1_000)
+        return `${(tokens / 1_000).toFixed(1)}k`;
+    return `${tokens}`;
+}
+//# sourceMappingURL=telegram-channel.js.map

package/dist/channel/telegram/telegram-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-channel.js","sourceRoot":"","sources":["../../../src/channel/telegram/telegram-channel.ts"],"names":[],"mappings":"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"}

package/dist/channel/telegram/telegram-sender.d.ts

@@ -0,0 +1,2 @@
+import TelegramBot from "node-telegram-bot-api";
+export declare function sendTelegramMessage(bot: TelegramBot, chatId: number, text: string, responseUrl?: string): Promise<void>;

package/dist/channel/telegram/telegram-sender.js

@@ -0,0 +1,72 @@
+import TelegramBot from "node-telegram-bot-api";
+import { t } from "../../i18n/index.js";
+import { logError } from "../../utils/log.js";
+import { SPLIT_LOOKBACK_RANGE } from "../../utils/constants.js";
+const TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
+const PAGINATION_FOOTER_RESERVE = 30;
+export async function sendTelegramMessage(bot, chatId, text, responseUrl) {
+    const pages = splitMessage(text, TELEGRAM_MAX_MESSAGE_LENGTH - PAGINATION_FOOTER_RESERVE);
+    for (let i = 0; i < pages.length; i++) {
+        let content = pages[i];
+        if (pages.length > 1) {
+            content = `${content}\n\n<i>[${i + 1}/${pages.length}]</i>`;
+        }
+        const isLastPage = i === pages.length - 1;
+        const opts = { parse_mode: "HTML" };
+        if (isLastPage && responseUrl) {
+            opts.reply_markup = buildResponseReplyMarkup(responseUrl);
+        }
+        try {
+            await bot.sendMessage(chatId, content, opts);
+        }
+        catch (err) {
+            logError(t("bot.sendFailed"), err);
+            const fallbackOpts = {};
+            if (isLastPage && responseUrl) {
+                fallbackOpts.reply_markup = buildResponseReplyMarkup(responseUrl);
+            }
+            try {
+                await bot.sendMessage(chatId, pages[i], fallbackOpts);
+            }
+            catch (err2) {
+                logError(t("bot.sendFallbackFailed"), err2);
+                await bot.sendMessage(chatId, pages[i]);
+            }
+        }
+    }
+}
+function splitMessage(text, maxLen) {
+    if (text.length <= maxLen)
+        return [text];
+    const pages = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLen) {
+            pages.push(remaining);
+            break;
+        }
+        const splitAt = findSplitPoint(remaining, maxLen);
+        pages.push(remaining.slice(0, splitAt));
+        remaining = remaining.slice(splitAt);
+    }
+    return pages;
+}
+function findSplitPoint(text, maxLen) {
+    for (let i = maxLen; i > maxLen - SPLIT_LOOKBACK_RANGE && i > 0; i--) {
+        if (text[i] === "\n" && text[i - 1] !== "\\")
+            return i + 1;
+    }
+    for (let i = maxLen; i > maxLen - SPLIT_LOOKBACK_RANGE && i > 0; i--) {
+        if (text[i] === " " && text[i - 1] !== "\\")
+            return i + 1;
+    }
+    return maxLen;
+}
+function buildResponseReplyMarkup(responseUrl) {
+    const buttonText = t("bot.viewDetails");
+    const button = responseUrl.startsWith("https://")
+        ? { text: buttonText, web_app: { url: responseUrl } }
+        : { text: buttonText, url: responseUrl };
+    return { inline_keyboard: [[button]] };
+}
+//# sourceMappingURL=telegram-sender.js.map

package/dist/channel/telegram/telegram-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-sender.js","sourceRoot":"","sources":["../../../src/channel/telegram/telegram-sender.ts"],"names":[],"mappings":"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"}

package/dist/channel/types.d.ts

@@ -0,0 +1,20 @@
+import type { GitChangeStatus } from "../utils/constants.js";
+export interface NotificationChannel {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    sendNotification(data: NotificationData, responseUrl?: string): Promise<void>;
+}
+export interface NotificationData {
+    projectName: string;
+    responseSummary: string;
+    durationMs: number;
+    gitChanges: GitChange[];
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+}
+export interface GitChange {
+    file: string;
+    status: GitChangeStatus;
+}

package/dist/channel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channel/types.ts"],"names":[],"mappings":""}

package/dist/commands/help.d.ts

@@ -0,0 +1 @@
+export declare function runHelp(): void;

package/dist/commands/help.js

@@ -0,0 +1,19 @@
+import * as p from "@clack/prompts";
+import { detectCliPrefix } from "../utils/install-detection.js";
+import { t } from "../i18n/index.js";
+export function runHelp() {
+    const prefix = detectCliPrefix();
+    p.intro(t("help.intro"));
+    p.log.message([
+        t("help.usage", { prefix }),
+        "",
+        t("help.commands"),
+        t("help.cmdNone"),
+        t("help.cmdSetup"),
+        t("help.cmdUpdate"),
+        t("help.cmdUninstall"),
+        t("help.cmdHelp"),
+    ].join("\n"));
+    p.outro(t("help.docs"));
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAErC,MAAM,UAAU,OAAO;IACrB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAEjC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzB,CAAC,CAAC,GAAG,CAAC,OAAO,CACX;QACE,CAAC,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3B,EAAE;QACF,CAAC,CAAC,eAAe,CAAC;QAClB,CAAC,CAAC,cAAc,CAAC;QACjB,CAAC,CAAC,eAAe,CAAC;QAClB,CAAC,CAAC,gBAAgB,CAAC;QACnB,CAAC,CAAC,mBAAmB,CAAC;QACtB,CAAC,CAAC,cAAc,CAAC;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;