Metadata-Version: 2.4
Name: buxcli
Version: 1.0.5
Summary: A simple CLI tool for alert you about your CLI.
Home-page: https://github.com/rushaad2911/buxcli
Author: Mohd. Rushaad Buxy
Author-email: m.rushaadq@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: inquirer
Requires-Dist: rich
Requires-Dist: click
Requires-Dist: dotenv
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Buxcli 🚀

**buxcli** is a professional command-line tool that runs shell commands and provides **automatic email notifications** for success, failure, or server startup. Perfect for developers and DevOps engineers who want real-time notifications without constantly monitoring terminals.

---

## Features ✨

- Send email notifications when commands succeed ✅ or fail ❌  
- Detect server startup and send instant notifications 🚀  
- First-time setup with Gmail + App Password  
- Verify credentials with a test email during setup  
- Automatic retry if credentials are invalid  
- Colorful, easy-to-read CLI output  
- Supports raw shell commands or via `run` command  

---

## Installation 💻

Install via pip:

```bash
pip install buxcli
```

Check Installation: 
```bash
buxcli --help
```

```bash

Output:

██████  ██    ██ ██   ██  ██████ ██      ██ 
██   ██ ██    ██  ██ ██  ██      ██      ██ 
██████  ██    ██   ███   ██      ██      ██ 
██   ██ ██    ██  ██ ██  ██      ██      ██ 
██████   ██████  ██   ██  ██████ ███████ ██ 

Run commands with automatic email notifications when they succeed, fail, or a server starts.

Examples:
  buxcli run "python manage.py runserver"
  buxcli docker pull ollama
Usage: buxcli [OPTIONS] [CMD]... COMMAND [ARGS]...

  buxcli - Run commands with automatic email notifications

Options:
  --help  Show this message and exit.

Commands:
  run  Run any shell command with email notifications

```

```bash
Supports Gmail with App Password (recommended for security)

Contributing 🤝
Contributions are welcome! Feel free to open issues or submit pull requests.

Fork the repository

Create your feature branch (git checkout -b feature/my-feature)

Commit your changes (git commit -m 'Add some feature')

Push to the branch (git push origin feature/my-feature)

Open a pull request

License 📝
This project is licensed under the MIT License. See the LICENSE file for details.

Contact 📧
Mohd. Rushaad Buxy
Email: m.rushaadq@gmail.com
GitHub: https://github.com/rushaad2911/Mycli

buxcli – Never miss a command status again! 🚀
```




