Telbot

Telbot

Go-based tool for managing Telkomsel accounts via **Telegram Bot**, **Terminal CLI**, or **MCP Server** (for AI agents).

Features

• 🔑 SMS OTP login with session caching
• 📊 Profile, balance, quota checking
• 📦 Browse recommended packages
• 🛍️ Purchase packages (Pulsa / QRIS)
• ⏰ Auto-buy monitor (auto-purchase when quota is depleted or below a custom MB threshold)
• 🔄 Auto re-login via OTP webhook (session renewal without manual intervention)
• 🤖 MCP server for AI agent integration

Quick Start

git clone https://github.com/0xtbug/telbot
cd telbot
cp .env.example .env   # fill in your tokens
go mod tidy

Modes

Flag	Description
--bot	Telegram bot (requires .env config)
--cli	Interactive terminal UI (Bubbletea)
--mcp	MCP server for AI agents (stdio)

go run . --bot       # Telegram bot
go run . --cli       # Terminal UI
go run . --mcp       # MCP server

Installation (Pre-built Binaries)

If you don't want to install Go or build it yourself, you can download the pre-compiled executables for Windows, Linux, and macOS directly from the **[Releases](https://github.com/0xtbug/telbot/releases)** page of this repository.

To install the binary globally so you can run `telbot` from any folder:

**Linux / macOS:**

1. Download the appropriate binary from the Releases page.
2. Make the file executable:

   chmod +x telbot-linux-amd64  # Replace with your downloaded file name

3. Move it to your global bin directory:

   sudo mv telbot-linux-amd64 /usr/local/bin/telbot

4. You can now run telbot from anywhere in your terminal.

**Windows:**

1. Download the Windows .exe executable from the Releases page.
2. Rename the downloaded file to telbot.exe.
3. Move it to a permanent folder, for example C:\telbot\.
4. Open the Windows Start menu, search for Edit the system environment variables, and open it.
5. Click **Environment Variabl