claude-telegram-mirror 0.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logger Configuration
+ */
+import winston from 'winston';
+export declare const logger: winston.Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAS9B,eAAO,MAAM,MAAM,gBAejB,CAAC;AAWH,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,28 @@
+/**
+ * Logger Configuration
+ */
+import winston from 'winston';
+const { combine, timestamp, printf, colorize } = winston.format;
+const logFormat = printf(({ level, message, timestamp, ...meta }) => {
+    const metaStr = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : '';
+    return `${timestamp} [${level}]: ${message}${metaStr}`;
+});
+export const logger = winston.createLogger({
+    level: process.env.LOG_LEVEL || 'info',
+    format: combine(timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), logFormat),
+    transports: [
+        new winston.transports.Console({
+            format: combine(colorize(), timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), logFormat)
+        })
+    ]
+});
+// Add file transport in production
+if (process.env.NODE_ENV === 'production') {
+    logger.add(new winston.transports.File({
+        filename: '/tmp/claude-telegram-mirror.log',
+        maxsize: 5242880, // 5MB
+        maxFiles: 3
+    }));
+}
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;AAEhE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,OAAO,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,MAAM,EAAE,OAAO,CACb,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC5C,SAAS,CACV;IACD,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,OAAO,CACb,QAAQ,EAAE,EACV,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC5C,SAAS,CACV;SACF,CAAC;KACH;CACF,CAAC,CAAC;AAEH,mCAAmC;AACnC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QACrC,QAAQ,EAAE,iCAAiC;QAC3C,OAAO,EAAE,OAAO,EAAE,MAAM;QACxB,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAED,eAAe,MAAM,CAAC"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "claude-telegram-mirror",
+  "version": "0.1.0",
+  "description": "Bidirectional Telegram integration for Claude Code CLI - monitor and control your Claude Code sessions from Telegram",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "claude-telegram-mirror": "./dist/cli.js",
+    "ctm": "./dist/cli.js",
+    "telegram-hook": "./scripts/telegram-hook.sh"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js start",
+    "daemon": "node dist/cli.js start --foreground",
+    "status": "node dist/cli.js status",
+    "install-hooks": "node dist/cli.js install-hooks",
+    "uninstall-hooks": "node dist/cli.js uninstall-hooks",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node postinstall.cjs",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "files": [
+    "dist/",
+    "scripts/",
+    "postinstall.cjs",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "telegram",
+    "cli",
+    "mirror",
+    "bot",
+    "claude-code",
+    "anthropic",
+    "ai",
+    "automation",
+    "remote-control",
+    "mobile"
+  ],
+  "author": "Robert E. Lee <robert@agidreams.us>",
+  "license": "MIT",
+  "homepage": "https://github.com/robertelee78/claude-telegram-mirror",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robertelee78/claude-telegram-mirror.git"
+  },
+  "bugs": {
+    "url": "https://github.com/robertelee78/claude-telegram-mirror/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/robertelee78"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "grammy": "^1.21.0",
+    "better-sqlite3": "^11.0.0",
+    "commander": "^12.0.0",
+    "winston": "^3.11.0",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.5"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0",
+    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "linux",
+    "darwin"
+  ]
+}

package/postinstall.cjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * Post-install script for claude-telegram-mirror
+ * Shows helpful guidance after npm install
+ */
+
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+// Try to load chalk, fall back to plain text if not available
+let chalk;
+try {
+  chalk = require('chalk');
+} catch (e) {
+  // Chalk not available, use plain text functions
+  const identity = (s) => s;
+  chalk = {
+    cyan: identity,
+    green: identity,
+    yellow: identity,
+    red: identity,
+    blue: identity,
+    gray: identity,
+    white: { bold: identity },
+  };
+}
+
+// Don't show guidance during CI or if TELEGRAM_BOT_TOKEN is already set
+if (process.env.CI || process.env.TELEGRAM_BOT_TOKEN) {
+  process.exit(0);
+}
+
+console.log('');
+console.log(chalk.cyan('╔════════════════════════════════════════════════════════════╗'));
+console.log(chalk.cyan('║') + chalk.white.bold('  Claude Telegram Mirror - Installation Complete!           ') + chalk.cyan('║'));
+console.log(chalk.cyan('╚════════════════════════════════════════════════════════════╝'));
+console.log('');
+
+console.log(chalk.yellow('📱 Quick Setup:'));
+console.log('');
+console.log('   ' + chalk.white.bold('1. Run the interactive setup:'));
+console.log('      ' + chalk.green('ctm setup'));
+console.log('');
+console.log('   ' + chalk.white.bold('2. Or configure manually:'));
+console.log('      ' + chalk.gray('export TELEGRAM_BOT_TOKEN="your-bot-token"'));
+console.log('      ' + chalk.gray('export TELEGRAM_CHAT_ID="your-chat-id"'));
+console.log('      ' + chalk.gray('export TELEGRAM_MIRROR=true'));
+console.log('');
+
+console.log(chalk.yellow('🔧 Commands:'));
+console.log('');
+console.log('   ' + chalk.green('ctm setup') + '           Interactive configuration wizard');
+console.log('   ' + chalk.green('ctm doctor') + '          Diagnose configuration issues');
+console.log('   ' + chalk.green('ctm start') + '           Start the mirror daemon');
+console.log('   ' + chalk.green('ctm status') + '          Show current status');
+console.log('   ' + chalk.green('ctm install-hooks') + '   Install Claude Code hooks');
+console.log('   ' + chalk.green('ctm service install') + ' Install as system service');
+console.log('');
+
+console.log(chalk.yellow('📚 Documentation:'));
+console.log('   ' + chalk.blue('https://github.com/robertelee78/claude-mobile'));
+console.log('');
+
+// Check for existing config
+const configDir = path.join(os.homedir(), '.config', 'claude-telegram-mirror');
+const configFile = path.join(configDir, 'config.json');
+
+if (fs.existsSync(configFile)) {
+  console.log(chalk.green('✓ Existing configuration found at:'));
+  console.log('   ' + chalk.gray(configFile));
+  console.log('');
+}
+
+console.log(chalk.gray('Run "ctm doctor" to verify your setup.'));
+console.log('');

package/scripts/claude-wrapper.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+#
+# Claude Code Wrapper with Telegram Mirror
+# Wraps existing claude command to enable Telegram mirroring
+#
+# Usage:
+#   claude-wrapper <original-claude-args>
+#
+# Or create aliases:
+#   alias dsp='TELEGRAM_MIRROR=true claude-wrapper --dangerously-skip-permissions'
+#   alias dsp-c='TELEGRAM_MIRROR=true claude-wrapper --dangerously-skip-permissions -c'
+#
+
+set -e
+
+# Get the directory of this script
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Check if Telegram mirror is enabled
+TELEGRAM_ENABLED="${TELEGRAM_MIRROR:-false}"
+
+# Bridge daemon socket path
+SOCKET_PATH="${TELEGRAM_BRIDGE_SOCKET:-/tmp/claude-telegram-bridge.sock}"
+
+# Start bridge daemon if needed
+start_bridge() {
+  if [[ ! -S "$SOCKET_PATH" ]]; then
+    echo "🔌 Starting Telegram bridge daemon..."
+
+    # Start in background
+    if command -v node &> /dev/null && [[ -f "$PACKAGE_DIR/dist/cli.js" ]]; then
+      node "$PACKAGE_DIR/dist/cli.js" start &
+      BRIDGE_PID=$!
+
+      # Wait for socket to be created (max 5 seconds)
+      for i in {1..50}; do
+        if [[ -S "$SOCKET_PATH" ]]; then
+          echo "✅ Bridge daemon started"
+          break
+        fi
+        sleep 0.1
+      done
+
+      if [[ ! -S "$SOCKET_PATH" ]]; then
+        echo "⚠️  Bridge daemon failed to start, continuing without Telegram mirror"
+        TELEGRAM_ENABLED="false"
+      fi
+    else
+      echo "⚠️  claude-telegram-mirror not installed properly"
+      TELEGRAM_ENABLED="false"
+    fi
+  fi
+}
+
+# Notify session start
+notify_start() {
+  if [[ -S "$SOCKET_PATH" ]]; then
+    local session_id="cli-$(date +%s)-$$"
+    local project_dir="$(pwd)"
+
+    echo "{\"type\":\"session_start\",\"sessionId\":\"$session_id\",\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"content\":\"Session started\",\"metadata\":{\"projectDir\":\"$project_dir\"}}" | \
+      nc -U -q0 "$SOCKET_PATH" 2>/dev/null || true
+
+    export TELEGRAM_SESSION_ID="$session_id"
+  fi
+}
+
+# Notify session end
+notify_end() {
+  if [[ -S "$SOCKET_PATH" && -n "$TELEGRAM_SESSION_ID" ]]; then
+    echo "{\"type\":\"session_end\",\"sessionId\":\"$TELEGRAM_SESSION_ID\",\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"content\":\"Session ended\"}" | \
+      nc -U -q0 "$SOCKET_PATH" 2>/dev/null || true
+  fi
+}
+
+# Cleanup on exit
+cleanup() {
+  notify_end
+
+  # Kill bridge daemon if we started it
+  if [[ -n "$BRIDGE_PID" ]]; then
+    kill "$BRIDGE_PID" 2>/dev/null || true
+  fi
+}
+
+# Main execution
+main() {
+  # Find the real claude command
+  CLAUDE_CMD=$(which claude 2>/dev/null || echo "")
+
+  if [[ -z "$CLAUDE_CMD" ]]; then
+    echo "❌ Claude CLI not found"
+    exit 1
+  fi
+
+  # Check if this is being called as a wrapper (avoid recursion)
+  if [[ "$CLAUDE_WRAPPER_ACTIVE" == "true" ]]; then
+    exec "$CLAUDE_CMD" "$@"
+  fi
+
+  export CLAUDE_WRAPPER_ACTIVE="true"
+
+  if [[ "$TELEGRAM_ENABLED" == "true" || "$TELEGRAM_ENABLED" == "1" ]]; then
+    # Start bridge if needed
+    start_bridge
+
+    # Setup cleanup trap
+    trap cleanup EXIT
+
+    # Notify session start
+    notify_start
+
+    echo "📱 Telegram mirror active"
+    echo ""
+  fi
+
+  # Execute claude with all arguments
+  exec "$CLAUDE_CMD" "$@"
+}
+
+main "$@"