Telegram Kiro Bot

A Python service that bridges Telegram with Kiro CLI, maintaining persistent conversation context.

Features

• Persistent Session: Maintains a single Kiro CLI session across all messages
• Auto Tool Trust: Automatically trusts all tools to avoid prompts
• Clean Output: Strips ANSI escape codes for Telegram compatibility
• User Filtering: Only responds to authorized user (configurable)
• Error Handling: Robust error handling and automatic recovery
• Progress Updates: Shows typing indicators during processing

Setup

1. Copy settings template and configure:

cp settings.ini.template settings.ini
# Edit settings.ini with your bot token and authorized user

2. Setup and run:

# Setup virtual environment and run tests
make setup
make test

# Run the bot
make run

Running as a Service

# Install and start service
make install
make service-start

# Check status and logs
make service-status
make service-logs

# Stop service
make service-stop

How It Works

1. Persistent Kiro Session: Starts kiro-cli chat --trust-all-tools once and keeps it running
2. Threaded I/O: Uses separate threads for input, output, and response processing
3. Auto Tool Trust: Automatically trusts all tools using /tools trust-all command and handles prompts
4. Smart Response Buffering: Accumulates output until prompt detected or timeout (3 seconds)
5. Message Processing: Sends user messages to Kiro, captures and buffers responses
6. Output Cleaning: Removes ANSI codes, filters prompts, and handles multi-line messages
7. Timeout Handling: Automatically sends buffered responses after inactivity
8. Telegram Integration: Uses python-telegram-bot library with thread-safe async messaging

Advantages over shell2telegram

• True Persistence: Single Kiro session maintains full context
• Better Performance: No process startup overhead per message
• Cleaner Output: Proper ANSI stripping and response filtering
• Error Recovery: Handles timeouts and connection issues
• Simpler Deployment: Single Python file, easy to manage as service

Logs

View logs with:

sudo journalctl -u telegram-kiro-bot -f