https://github.com/ltk-mxz/github-telegram-bot
A Telegram bot to easily manage your GitHub repositories.
https://github.com/ltk-mxz/github-telegram-bot
bot telegram telegrambot
Last synced: 4 months ago
JSON representation
A Telegram bot to easily manage your GitHub repositories.
- Host: GitHub
- URL: https://github.com/ltk-mxz/github-telegram-bot
- Owner: Ltk-Mxz
- Created: 2025-05-30T10:18:11.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-19T13:28:44.000Z (6 months ago)
- Last Synced: 2025-12-22T05:25:53.539Z (6 months ago)
- Topics: bot, telegram, telegrambot
- Language: JavaScript
- Homepage:
- Size: 68.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GitHub Telegram Bot
A Telegram bot to easily manage your GitHub repositories.
## Installation
```bash
git clone github.com/Ltk-Mxz/github-telegram-bot.git
cd github-telegram-bot
npm install
cp .env.example .env
# Fill in your tokens in the .env file
```
## Usage
Start the bot:
```bash
npm start
```
## Available Commands
- `/createrepo `
Create a GitHub repository.
- `/listrepos`
List your repositories (pagination possible).
- `/deleterepo `
Delete a repository.
- `/addcollab `
Add a collaborator to a repository.
- `/listcollab `
List collaborators of a repository.
- `/createissue | | `
Create an issue in a repository.
- `/listissues `
List open issues in a repository (pagination possible).
- `/repoinfo `
Show detailed information about a repository.
- `/changevisibility `
Change the visibility of a repository.
- `/listbranches `
List branches of a repository (pagination possible).
- `/createbranch `
Create a branch from another branch.
- `/lastcommits [n]`
Show the last commits of a branch.
- `/setwebhook `
Add a webhook to a repository.
- `/searchrepo `
Search public repositories on GitHub.
- `/searchmyrepo `
Search your own repositories.
## Examples
```
/createrepo myproject public
/listrepos
/deleterepo myproject
/addcollab myproject githubuser
/listcollab myproject
/createissue myproject | Critical bug | There is a bug to fix
/listissues myproject
/repoinfo myproject
/changevisibility myproject private
/listbranches myproject
/createbranch myproject dev main
/lastcommits myproject main 5
/setwebhook myproject https://myurl.com/webhook
/searchrepo telegram
/searchmyrepo bot
```
## Configuration
Create a `.env` file in the root directory with the following variables:
```env
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
GITHUB_TOKEN=your_github_token
```
## Requirements
- Node.js (v14 or higher)
- npm (Node Package Manager)
- A GitHub account
- A Telegram account
- A bot created with BotFather on Telegram
- A GitHub personal access token with the necessary permissions
- A `.env` file with your tokens
- A server to run the bot (optional, can be run locally)
## License
This project is licensed under the MIT License
## Contributing
Contributions are welcome! Please open an issue or submit a pull request.
## Disclaimer
This bot is not affiliated with GitHub or Telegram. Use at your own risk. The author is not responsible for any issues that may arise from using this bot.
## Security
**Never share your `.env` file!**
## Author
This bot was created by [Ltk-Mxz](https://github.com/Ltk-Mxz).
## Contact
For any questions or issues, please open an issue on the GitHub repository or contact me on email .