@thxmxx/telegram-mcp 1.0.0 → 1.2.0

package/.github/workflows/publish.yaml

@@ -0,0 +1,68 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    types: [closed]
+    branches: [main]
+
+jobs:
+  publish:
+    if: github.event_name == 'push' || github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # needed to push the version bump commit
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Determine version bump
+        id: bump
+        run: |
+          # Get the commit message that triggered this run
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            MSG="${{ github.event.pull_request.title }}"
+          else
+            MSG="$(git log -1 --pretty=%s)"
+          fi
+
+          echo "Commit message: $MSG"
+
+          # Detect breaking change
+          if echo "$MSG" | grep -qiE "BREAKING CHANGE|!:"; then
+            echo "type=major" >> $GITHUB_OUTPUT
+          # feat → minor
+          elif echo "$MSG" | grep -qiE "^feat(\(.+\))?:"; then
+            echo "type=minor" >> $GITHUB_OUTPUT
+          # everything else → patch
+          else
+            echo "type=patch" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Bump version
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          npm version ${{ steps.bump.outputs.type }} --no-git-tag-version
+          VERSION=$(node -p "require('./package.json').version")
+          git add package.json
+          git commit -m "chore: bump version to $VERSION [skip ci]"
+          git push
+
+      - name: Publish
+        run: npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -12,7 +12,15 @@ The wizard asks for your Telegram bot token and user ID, registers the MCP serve
 
 ## Usage
 
-In any Claude Code session, activate Telegram with the slash command:
+Start Claude Code without permission prompts so it can work autonomously:
+
+```bash
+claude --dangerously-skip-permissions
+```
+
+> ⚠️ This flag disables all tool confirmation prompts — file writes, shell commands, everything. Use only on your own machine for personal workflows.
+
+Then activate Telegram in any session:
 
 ```
 /use-telegram
@@ -85,4 +93,4 @@ On first use, Claude Code will ask you to approve the three tools this MCP serve
 
 ## License
 
-MIT
+MIT

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@thxmxx/telegram-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Telegram bridge for Claude Code — notify, ask and choose via your phone",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thxmxx/telegram-mcp"
+  },
   "bin": {
     "telegram-mcp": "./src/cli.js"
   },
@@ -11,6 +15,8 @@
     "node-telegram-bot-api": "^0.66.0",
     "dotenv": "^16.0.0"
   },
-  "engines": { "node": ">=18" },
+  "engines": {
+    "node": ">=18"
+  },
   "license": "MIT"
 }

package/src/setup.js

@@ -17,17 +17,21 @@ import { mkdirSync, writeFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 
-const rl  = createInterface({ input, output });
+const rl = createInterface({ input, output });
 const ask = (q) => rl.question(q);
 
-const BOLD  = "\x1b[1m";
+const BOLD = "\x1b[1m";
 const GREEN = "\x1b[32m";
-const CYAN  = "\x1b[36m";
-const DIM   = "\x1b[2m";
+const CYAN = "\x1b[36m";
+const DIM = "\x1b[2m";
 const RESET = "\x1b[0m";
 
-const ok  = (msg) => console.log(`${GREEN}✔${RESET}  ${msg}`);
-const die = (msg) => { console.error(`\x1b[31m✘${RESET}  ${msg}`); rl.close(); exit(1); };
+const ok = (msg) => console.log(`${GREEN}✔${RESET}  ${msg}`);
+const die = (msg) => {
+  console.error(`\x1b[31m✘${RESET}  ${msg}`);
+  rl.close();
+  exit(1);
+};
 
 // ── Pre-flight ────────────────────────────────────────────────────────────────
 
@@ -38,7 +42,9 @@ if (major < 18) die(`Node.js 18+ required (you have ${process.versions.node})`);
 ok(`Node.js ${process.versions.node}`);
 
 try {
-  const ver = execFileSync("claude", ["--version"], { encoding: "utf8" }).trim();
+  const ver = execFileSync("claude", ["--version"], {
+    encoding: "utf8",
+  }).trim();
   ok(`Claude Code: ${ver}`);
 } catch {
   die("`claude` not found. Install: https://docs.claude.ai/claude-code");
@@ -71,31 +77,51 @@ console.log(`\n${BOLD}Registering MCP server globally…${RESET}`);
 const serverPath = new URL("./index.js", import.meta.url).pathname;
 
 try {
-  execFileSync("claude", [
-    "mcp", "add", "--scope", "user",   // global, persists across all projects
-    "telegram-mcp",
-    "-e", `TELEGRAM_BOT_TOKEN=${token}`,
-    "-e", `TELEGRAM_CHAT_ID=${chatId}`,
-    "--", "node", serverPath,
-  ], { stdio: "inherit" });
+  execFileSync(
+    "claude",
+    [
+      "mcp",
+      "add",
+      "--scope",
+      "user", // global, persists across all projects
+      "telegram-mcp",
+      "-e",
+      `TELEGRAM_BOT_TOKEN=${token}`,
+      "-e",
+      `TELEGRAM_CHAT_ID=${chatId}`,
+      "--",
+      "node",
+      serverPath,
+    ],
+    { stdio: "inherit" },
+  );
 } catch {
   // Fallback: older Claude Code versions without --scope flag
   try {
-    execFileSync("claude", [
-      "mcp", "add",
-      "telegram-mcp",
-      "-e", `TELEGRAM_BOT_TOKEN=${token}`,
-      "-e", `TELEGRAM_CHAT_ID=${chatId}`,
-      "--", "node", serverPath,
-    ], { stdio: "inherit" });
+    execFileSync(
+      "claude",
+      [
+        "mcp",
+        "add",
+        "telegram-mcp",
+        "-e",
+        `TELEGRAM_BOT_TOKEN=${token}`,
+        "-e",
+        `TELEGRAM_CHAT_ID=${chatId}`,
+        "--",
+        "node",
+        serverPath,
+      ],
+      { stdio: "inherit" },
+    );
   } catch {
     die(
       "`claude mcp add` failed.\n" +
-      "  Update Claude Code: https://docs.claude.ai/claude-code\n\n" +
-      "  Manual config:\n" +
-      `    TELEGRAM_BOT_TOKEN=${token}\n` +
-      `    TELEGRAM_CHAT_ID=${chatId}\n` +
-      `    command: node ${serverPath}`
+        "  Update Claude Code: https://docs.claude.ai/claude-code\n\n" +
+        "  Manual config:\n" +
+        `    TELEGRAM_BOT_TOKEN=${token}\n` +
+        `    TELEGRAM_CHAT_ID=${chatId}\n` +
+        `    command: node ${serverPath}`,
     );
   }
 }
@@ -108,17 +134,19 @@ const commandsDir = join(homedir(), ".claude", "commands");
 mkdirSync(commandsDir, { recursive: true });
 
 const commandPath = join(commandsDir, "use-telegram.md");
-writeFileSync(commandPath, `# use-telegram
+writeFileSync(
+  commandPath,
+  `# use-telegram
 
 Activate Telegram integration for this Claude Code session.
 
 ## What this does
 
-Enables the telegram_notify, telegram_ask and telegram_choose tools so you
-can be notified and asked questions on your phone while Claude works.
+Enables telegram_notify, telegram_ask and telegram_choose so the user
+receives updates and can respond from their phone or terminal.
 
-The instance name is derived automatically from the current folder and
-session ID, so messages on Telegram always show which session is talking.
+This session runs with --dangerously-skip-permissions so Claude never
+interrupts the task to ask for tool confirmations in the terminal.
 
 ## Modes
 
@@ -127,21 +155,24 @@ session ID, so messages on Telegram always show which session is talking.
 
 ## Behaviour
 
-When this command is active:
-- Use telegram_notify for progress updates and completed tasks
-- Use telegram_ask when you need a free-form answer from the user
-- Use telegram_choose when the user must pick from known options
-- Always prefix messages with the auto-generated instance label
-- Mirror every question to the terminal too — whoever answers first wins
-- After any long-running task, send a completion summary via telegram_notify
+You MUST use the Telegram tools for this session. Specifically:
+
+- Call telegram_notify **immediately** to confirm Telegram is active
+- Call telegram_notify for every meaningful progress update
+- Call telegram_notify when any task is fully complete, with a summary
+- Call telegram_ask whenever you need a free-form answer from the user
+- Call telegram_choose whenever the user must pick from known options
+- Do NOT ask questions in the terminal — always use telegram_ask or telegram_choose
 
 ## Instance naming
 
-Generate the instance label as: \`{folder-name}#{short-session-id}\`
-Example: \`backend#a3f2\`, \`frontend#9c11\`
+At the start of this session, generate a label: \`{folder-name}#{4-char-random-hex}\`
+Examples: \`backend#a3f2\`, \`frontend#9c11\`
 
-Use the same label for the entire session.
-`);
+Use this exact label in every Telegram message for the entire session.
+Send as first message: \`[label] ✅ Telegram active — ready.\`
+`,
+);
 
 ok(`Slash command installed → ${commandPath}`);
 
@@ -150,7 +181,11 @@ ok(`Slash command installed → ${commandPath}`);
 console.log(`
 ${GREEN}${BOLD}All done!${RESET}
 
-  Restart Claude Code. From now on, in any session:
+  Start Claude Code with:
+
+    ${BOLD}claude --dangerously-skip-permissions${RESET}
+
+  Then activate Telegram in any session:
 
     ${BOLD}/use-telegram${RESET}           full mode (notify + ask + choose)
     ${BOLD}/use-telegram notify${RESET}    notifications only