🗣️ bhai-run

bhai-run is a simple and fun CLI tool for developers that runs your project's development server and talks to you when something happens.

Instead of typing:

npm run dev

you can simply type:

bhai

When your server starts successfully, bhai says:

🔊 Chal bhai, server chalu ho gaya!

If the server encounters an error, bhai says:

🔊 Kya kar raha hai bhai!

🚀 Installation

Install bhai-run globally using npm:

npm install -g bhai-run

After installation, check that it works:

bhai

▶️ How to Use

Go inside any project that has a dev script in its package.json.

For example:

cd my-project

Then run:

bhai

Instead of manually running:

npm run dev

bhai automatically runs your project's development server.

📦 Example

Suppose your project has this package.json:

{
  "scripts": {
    "dev": "vite"
  }
}

Normally you would run:

npm run dev

With bhai-run, simply run:

bhai

You will see your normal server output, and when the server is ready, bhai will play a voice notification.

Example:

🚀 Starting your server...

> [email protected] dev
> vite

VITE ready in 400 ms

🔊 Chal bhai, server chalu ho gaya!

🛠️ Requirements

• Node.js
• npm
• A project with an npm run dev script

Windows

The current version uses Windows PowerShell for voice/audio playback, so the audio notification feature is currently designed for Windows.

Cross-platform support may be added in the future.

🎯 Why bhai-run?

Because sometimes you don't want to keep staring at the terminal waiting for your server to start. 😄

bhai-run gives you a simple voice notification so you know when your development server is ready.

🔄 Updating

To update to the latest version:

npm install -g bhai-run@latest

Check the installed version:

npm list -g bhai-run

🧪 Local Development

Clone the repository:

git clone https://github.com/YOUR_USERNAME/bhai-run.git

Enter the project:

cd bhai-run

Install dependencies:

npm install

Link the CLI locally:

npm link

Now you can use:

bhai

from another project.

📁 Project Structure

bhai-run/
├── audio/
│   ├── server_chalu.wav
│   └── kya_karraha_hai_bhai.wav
├── index.js
├── package.json
├── package-lock.json
└── README.md

📜 License

This project is licensed under the MIT License.

👨‍💻 Author

Created by Tousif.

If you find bhai-run funny or useful, give the repository a ⭐ on GitHub!