Skip to content

v2.1.0 - First Stable Release

Choose a tag to compare

View all tags
@artickc artickc released this 10 Jul 00:56
· 26 commits to main since this release
v2.1.0
f08de5b

First Stable Release - v2.1.0

Grok Telegram Bot is now stable. This is the first production-ready release with all features complete and verified.

Control the official Grok Build CLI (grok) from Telegram over the Agent Client Protocol (ACP). Sign in with your xAI account, switch projects, resume sessions, stream responses with live diffs, queue follow-ups, manage multiple sign-ins, and run 24/7 as a cross-platform background service.

Complete Feature Set

  • Projects and Sessions - Browse folders, create projects, resume/attach to live sessions, multi-session control with /running
  • Streaming and Rendering - Live typing indicators, MarkdownV2 rendering, unified edit diffs, chunking for long messages
  • Tool Call Visibility - Rich detail for every tool: searches (pattern + scope + filters), reads (path + line/offset), edits (diff blocks with stats), writes (content preview + syntax highlighting), deletes, moves (source to dest), shell commands (bash blocks), fetches (URL + method + body), web searches, MCP calls (server + method + args)
  • Tool Status Tracking - See pending to completed/failed for each tool call as it completes
  • Subagent Visibility - Watch subagents start, work, and finish in real-time
  • Auth and Accounts - xAI account sign-in (grok login), XAI_API_KEY support, multi-account with /accounts, auto-rotate on failure
  • Self-Healing - Auto-fork on context-full, transient-error retry with backoff, auto-restart, single-instance guard
  • Progress Bar - Live {progress: N%} bar with bot-computed fallback
  • Scheduled Tasks - Run tasks on a schedule with /tasks
  • Voice Messages - Transcribe voice to prompts (configurable STT endpoint)
  • Image Prompts - Send photos to the agent, receive generated images back
  • File Ingestion - Send documents for the agent to read
  • MCP Control - /mcp to inspect, health-check, enable/disable MCP servers
  • Inline Approvals - Approve/deny risky tool calls from Telegram buttons
  • Cross-Platform Daemon - Windows (Startup folder / Task Scheduler), Linux (systemd), macOS (launchd)
  • npm Package - npm install -g grok-telegram-bot gives you the grok-tg CLI
  • Auto-Update - Checks hourly, updates when idle
  • Status Panel - Pinned live status with activity, location, config, progress
  • Threaded Replies - Every message threaded to your prompt with searchable hashtags
  • Self-Cleaning UI - Transient menus auto-remove for a tidy chat history

Install

npm install -g grok-telegram-bot
grok-tg setup    # configure .env + detect grok CLI
grok-tg install  # install as 24/7 background service

Or see the Install Guide.

Architecture

A fork of artickc/kiro-telegram-bot, re-architected for the Grok Build CLI (grok agent stdio) over ACP.

  • Runtime: Node.js >= 20, TypeScript via tsx (no build step)
  • Key deps: grammy (Telegram), dotenv, diff
  • Entry point: src/index.ts / CLI/daemon: src/cli.ts

Full changelog: CHANGELOG.md

Assets 2
Loading