https://github.com/sanda0/xrun

Run multiple project commands effortlessly in a single terminal session. Simplify your workflow with runit!
https://github.com/sanda0/xrun

automation cli-tool developer-tools golang open-source project-management utility

Last synced: 2 days ago
JSON representation

Run multiple project commands effortlessly in a single terminal session. Simplify your workflow with runit!

• Host: GitHub
• URL: https://github.com/sanda0/xrun
• Owner: sanda0
• Created: 2025-01-18T10:15:16.000Z (16 days ago)
• Default Branch: main
• Last Pushed: 2025-01-23T09:36:32.000Z (11 days ago)
• Last Synced: 2025-01-23T10:29:30.798Z (11 days ago)
• Topics: automation, cli-tool, developer-tools, golang, open-source, project-management, utility
• Language: Go
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ✨ xrun ✨

A utility tool to streamline running multiple project commands effortlessly in a single terminal session! Perfect for managing development environments with ease.

---

## ⚡ Features

- Define and manage multiple commands in a single JSON configuration file.

- Execute commands simultaneously with ease.

- Works with any project—Laravel, Vue, Node.js, etc.

---

## 🔧 Installation (Linux)

### 🔄 Download

```bash

curl -s https://api.github.com/repos/sanda0/xrun/releases/latest \

| grep "browser_download_url" \

| grep "xrun-linux-amd64" \

| cut -d '"' -f 4 \

| xargs curl -L -o xrun

```

### 🔧 Install

```bash

sudo chmod +x xrun && sudo mv xrun /usr/bin/xrun

```

---

## 🚀 How to Use

### 🔍 Step 1: Go to Your Project Folder

```bash

cd //project

```

### 🔄 Step 2: Initialize Configuration

Run the init command to generate the configuration file:

```bash

xrun --init

```

You will see a file named `config.xrun.json` in your project directory. Open it to edit the configuration.

### 🗄 Step 3: Edit Configuration File

Here’s an example of how your `config.xrun.json` might look:

```json

{

  "Commands": [

    {

      "Label": "Laravel",

      "Color": "red",

      "CmdStr": "php artisan serve",

      "ExecPath": "."

    },

    {

      "Label": "Vue",

      "Color": "green",

      "CmdStr": "npm run dev",

      "ExecPath": "."

    },

    {

      "Label": "Open VsCode",

      "Color": "blue",

      "CmdStr": "code .",

      "ExecPath": "."

    }

  ]

}

```

### 🔀 Step 4: Run Commands

While in your project directory, simply run:

```bash

xrun

```

### 👇 Output Example

```bash

▄   ▄  ▄▄▄ █  ▐▌▄▄▄▄  

 ▀▄▀  █    ▀▄▄▞▘█   █ 

▄▀ ▀▄ █         █   █ 

                        

Configured Commands:

Laravel ->   php artisan serve

Vue ->   npm run dev

Open VsCode ->   code .

========================

Running command: Open VsCode

Running command: Vue

Running command: Laravel

```

---

## 🎉 Enjoy Productivity Boost!

With `xrun`, managing your development environment has never been easier! Happy coding! 🚀

---

## 🛠 Feedback and Contributions

Feel free to open issues or submit pull requests. Let’s make `xrun` better together! ✨