🚀 AppManagerCLI

AppManagerCLI is a simple command-line tool that allows you to add, manage, and launch your favorite applications from a centralized configuration.

What is AppManagerCLI?

AppManagerCLI lets you register applications with custom commands and launch them quickly from the terminal using a simple numeric ID system.

Perfect for developers who frequently use the same tools and want a centralized launcher with built-in logging.

✨ Features

• ⚡ High Performance: Zero bloat, instant execution, and minimal system footprint.

• 📂 Central Gateway Architecture: Handle all remote configurations and API endpoints efficiently from a centralized setup.

• 🎨 Clean Terminal UI: Standard-compliant, structured, and color-coded console output for smooth debugging.

🚀 Getting Started

📋 Prerequisites

Before installing, ensure your environment meets the following requirements:

• Operating System: Linux (Debian/Ubuntu based, RHL/Fedora based, Arch based etc.) or macOS
• Runtime: PHP-cli or PHP (Version 7.4 or higher recommended)

⚙️ Installation

Choose one of the methods below to get started:

Method 1: Quick Auto-Installation (Recommended)

---

Run the following single-line command in your terminal. It will automatically download and set up the AppManagerCLI environment for you:

curl -sSL https://raw.githubusercontent.com/JoyRay0/AppManagerCLI/main/installer.sh | bash

Method 2: Manual Installation

---

If you prefer to configure it yourself, follow these steps:

1. Install PHP : Ensure PHP is installed on your system.

2. Download Release : Download the appmanager execution file from the latest release folder.

3. Run the App : Navigate to the folder and execute the file via PHP:

php appmanager

🛠️ Usage & Commands

appmanager

or

php appmanager

Supported Commands

Command	Description
appmanager list or php appmanager list	Display the comprehensive list of available commands and titles.
appmanager add or php appmanager add	Initialize and add a new application to the manager.
appmanager delete or php appmanager delete	Safely remove an application from tracking.
appmanager reset or php appmanager reset	Hard-reset the entire environment setup and configs.
appmanager run [id] or php appmanager run [id]	Launch an installed application directly using its assigned number or ID.
appmanager log clear or php appmanager log clear	Removes all log files generated by AppManager and resets the log directory.

Demo

➕ Add Single Command

$ appmanager add

[1] Single Command
[2] Multiple Command

=>1

Enter App ID :
=>1

Enter App Title :
=>Firefox

Enter App Command :
=>firefox

[✔] App Saved Successfully

➕ Add Multiple Command

$ appmanager add

[1] Single Command
[2] Multiple Command

=>2

Enter App ID :
=>2

Enter App Title :
=>Git

Enter 1st Command :
=>git status

Enter 2nd Command :
=>git add .

Enter 3rd Command :
=>git branch -M main

Enter 4th Command :
=>git commit -m"demo commit"

Enter 5th Command :
=>git push origin main

[✔] App Saved Successfully

▶ See the App and Run App via ID

$ appmanager

[1] Firefox
[2] Git

Enter App ID :
=>1

============================
Launching Firefox
============================

▶ Run App via ID

$ appmanager run 2

============================
Launching Git
============================

📋 To See the App List

$ appmanager list

No  >> Name  >> Commands

1   >> Firefox  >> [ firefox ]

2   >> Git  >> [ git status ], [ git add . ], [ git branch -M main ], [ git commit -m"demo commit" ], [ git push origin main ]

🗑 Delete the App

$ appmanager delete

Enter App ID :
=>1

[✔] Delete Successfully

♻ Reset the Application to Delete all App Commands

$ appmanager reset

Are you sure you want reset all [Y/n]:
=>Y

[✔] Reset Successfully

🧹 Clear all log file

$ appmanager log clear

Are you sure? [Y/n]:
=>Y

[✔] Logs Deleted Successfully

📦 Data & Activity Tracking

The core system automatically structures and persists your settings and activity logs inside the /home/username/appmanager or /Users/username/appmanager directory:

• app_commands.json : This file tracks the internal indexing of all added applications. It dynamically lists every app with its specific Number, Title, and Command configuration.

• logs/YYYY-MM.txt : Monthly log files containing timestamps, executed commands, and status information to help with debugging and tracking application activity.

🤝 Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project

2. Create your Feature Branch (git checkout -b feature/AmazingFeature)

3. Commit your Changes (git commit -m 'Add some AmazingFeature')

4. Push to the Branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.