Ryoowa1303

🤖 kiro-telegram-bot - Control your coding sessions from Telegram

This application lets you control your Kiro CLI tools directly from your Telegram account. You can switch between your coding projects, start or pause sessions, and receive updates about your code. The software runs as a background service on your computer, so your connection remains active at all times.

📥 How to download the software

1. Visit the official release page.
2. Look for the section labeled “Assets” at the bottom of the newest version.
3. Click the file that ends in “.exe” to save it to your computer.
4. Move this file to a folder where you keep your applications.
5. Double-click the file to start the installation process.

🛠 Features

• Remote session management: Switch projects and resume coding sessions from your phone.
• Real-time feedback: Receive data streams directly in your Telegram chat.
• Code diffs: See changes made to your files through formatted messages.
• Persistent operation: The background service ensures your connection stays alive 24/7.
• Queueing: Store multiple follow-up tasks while you are away from your workstation.

💻 System requirements

• Operating System: Windows 10 or Windows 11.
• Memory: At least 2GB of available RAM.
• Storage: 100MB of free disk space.
• Network: An active internet connection for Telegram communication.
• Prerequisites: You must have the Kiro CLI installed and configured on your machine before running this bot.

⚙️ Initial setup

1. Open your Telegram app and search for the BotFather to create a new bot token.
2. Copy the token provided by BotFather.
3. Once the software starts, a configuration window will appear.
4. Paste your token into the field labeled “Telegram Bot Token.”
5. Save your settings.
6. The application will minimize to your system tray. This area is located in the bottom right corner of your taskbar, near the clock.
7. Right-click the icon to adjust your preferences or to close the software.

🔐 Security and access

The application works by using the Agent Client Protocol to talk to your local machine. It only accepts commands from the Telegram account you link during the setup process. Your credentials and file paths remain on your computer. The bot does not transmit your personal data to third-party servers.

🧩 Common questions

Does the bot need to run all the time? Yes. To maintain a constant connection between your Telegram app and your computer, the background service must stay active. If you close the program, your session status will show as offline.

Why does my antivirus software show a warning? Because this application acts as a background service, some security software may flag it. You can safely add an exception for this folder in your antivirus settings.

How do I update the software? When a new version becomes available, revisit the download page and repeat the download steps. The installer overwrites the old version while keeping your settings intact.

What happens if I lose my internet connection? The bot enters a waiting mode. It will attempt to reconnect to the Telegram servers as soon as your network access returns. You will see a notification in your chat once the bot comes back online.

📁 Troubleshooting tips

• Check the tray icon: If you cannot send commands, check the system tray icon. A green light means the connection is active. A red light means the bot is disconnected.
• Verify your token: If the bot does not respond, double-check that you entered the correct BotFather token in the settings menu.
• Restart the service: If the application behaves in an odd way, right-click the tray icon and select “Restart Service.”
• Review your logs: If you face persistent issues, look for the “log.txt” file inside the folder where you installed the application. This file lists recent actions and any errors the bot encountered.

💡 Best practices for operation

• Use separate bots: If you manage multiple workstations, create a unique bot token for each one. This prevents commands from getting mixed up.
• Keep your notification settings clear: Use Telegram’s “Mute” feature for the bot if you receive too many automated updates during the day.
• Secure your account: Always use two-factor authentication on your Telegram account to prevent unauthorized access to your coding tools.
• Naming projects: Use short, descriptive names for your coding projects within your CLI config files. This makes switching projects via Telegram much faster.
• Power settings: Ensure your computer does not go into deep sleep mode if you need the bot to remain active throughout the night. Adjust your Windows power settings to “High Performance” if connections drop frequently.