Skip to content

Releases: terranc/claude-telegram-bot-bridge

Release v0.8.2

09 Mar 16:38

Choose a tag to compare

Fixed

  • Add event loop watchdog that detects zombie state (asyncio loop closed but process alive) and force-exits, allowing start.sh auto-restart to recover
  • Enable launchd KeepAlive so the service auto-restarts even if start.sh itself exits (e.g. rapid crash limit)

Changed

  • Enhanced --status command to detect inactive bots via log mtime checking, reporting detailed diagnostics instead of a misleading "running" status

Release v0.8.1

08 Mar 04:43

Choose a tag to compare

Fixed

  • Volcengine voice transcription now deletes the temporary TOS object after ASR completes, preventing staged voice files from accumulating over time
  • TOS cleanup failures are isolated to logs and no longer affect user-facing transcription replies

Changed

  • Extended TOS uploader API to return uploaded object metadata (object_key + signed URL) for explicit post-transcription cleanup
  • Added tests covering TOS object deletion on both success and failure paths

Release v0.8.0

07 Mar 18:21

Choose a tag to compare

Added

  • macOS voice reply mode with TTS support: bot automatically replies with voice when user sends voice messages, using macOS say command + ffmpeg conversion
  • Smart voice delivery strategy based on response length (voice-only, text+voice, or text-only fallback)
  • VOICE_REPLY_PERSONA config for selecting macOS TTS voice persona

Fixed

  • Voice reply mode gracefully falls back to text on non-macOS platforms

Changed

  • Updated README documentation (EN/ZH) with voice reply mode usage guide

Release v0.7.0

07 Mar 16:38

Choose a tag to compare

Added

  • Volcengine ASR support for voice transcription as an alternative to OpenAI Whisper
  • TOS (Tencent Object Storage) upload flow for Volcengine ASR integration

Changed

  • Added Star History chart to README files

Release v0.6.3

06 Mar 04:00

Choose a tag to compare

Changed

  • Renamed project from "Telegram Skill Bot" to "Claude Telegram Bot Bridge"
  • Updated project name in README.md, README-zh.md, and start.sh
  • Changed version display from "Bot version" to "Bridge version"
  • Simplified update notification to non-interactive text prompt

Release v0.6.2

06 Mar 03:40

Choose a tag to compare

Added

  • Auto-update check on startup with 1-hour cache to detect new releases
  • Interactive upgrade prompt when update is available (upgrade now / skip)
  • --upgrade command for one-click bot updates via git pull and dependency reinstall
  • Version comparison logic to determine if update is needed
  • Graceful handling of network failures during update check

Changed

  • Updated README.md and README-zh.md with upgrade command documentation
  • Added auto-update feature to Operations section in documentation

Release v0.6.1

05 Mar 05:31

Choose a tag to compare

Changed

  • Simplified bot command descriptions for better user experience in Telegram command menu

Release v0.6.0

05 Mar 05:25

Choose a tag to compare

Added

  • /revert command to restore conversation to any previous message state
  • 5 revert modes: full restore (code + conversation), conversation only, code only, summarize from point, or cancel
  • Paginated history browser showing last 50 messages with inline keyboard navigation
  • Priority handling for /revert: bypasses message queue limit and cancels active operations
  • Interactive mode selection via Telegram inline buttons
  • Conversation state restoration by truncating SDK JSONL files to selected message

Changed

  • Updated documentation (README.md, README-zh.md) with /revert usage examples
  • Improved button text consistency: changed "Never mind" to "Cancel"

Release v0.5.0

04 Mar 20:32

Choose a tag to compare

Added

  • Native Telegram voice message support with automatic transcription via OpenAI Whisper API
  • Audio format detection and conversion (OGG/AMR → MP3) using ffmpeg
  • Voice message preview in chat: 🎤 Voice: [transcribed text] before forwarding to Claude
  • Priority /stop command: immediately cancels running tasks and voice transcription, even when message queue is full
  • Comprehensive test coverage for audio processing, transcription, and voice message flow
  • Voice configuration options: OPENAI_API_KEY, OPENAI_BASE_URL, WHISPER_MODEL, MAX_VOICE_DURATION, FFMPEG_PATH
  • Automatic cleanup of temporary audio files and stale audio detection
  • Retry logic with exponential backoff for Whisper API calls
  • Voice message duration validation and cost/duration logging

Changed

  • /setup skill now includes optional voice message configuration step
  • .env.example updated with voice-related configuration options
  • Enhanced error handling for voice message processing with user-friendly error messages
  • Updated documentation (README, CLAUDE.md) with voice message feature details

Release v0.4.0

03 Mar 18:44

Choose a tag to compare

Added

  • /setup skill for conversational, multi-language installation via Claude Code
  • Support for installation in any language (English, Chinese, Japanese, Spanish, French, German, etc.)
  • Interactive installation wizard with 4-step process (system check, configuration, Python environment, completion)

Changed

  • Renamed install.sh to setup.sh for consistency with skill naming
  • Moved Python virtual environment creation and dependency installation from start.sh to setup.sh
  • start.sh now checks for completed installation and provides friendly error message if not installed
  • Installation flow now requires running setup.sh or /setup skill before start.sh
  • Improved installation prompts with better formatting and clearer instructions
  • Fixed color code rendering issues in installation scripts (added -e flag to all echo commands with color variables)

Fixed

  • Script references in README updated from install.sh to setup.sh
  • Command examples in documentation now reflect new installation flow