🚀 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 and others distros.) or macOS

⚙️ 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.Download Release : Download the appmanager execution file from the latest release folder.

2.Run the App : Navigate to the folder and execute the file:

appmanager

🛠️ Usage & Commands

appmanager

or

./appmanager

Supported Commands

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

Demo

➕ Add Single Command

$ appmanager add

ID :
>1

Title :
>Firefox

Commands (enclose each command in double quotes. Single quotes are allowed inside double quotes. Example: "A" "B" "C" "D 'd'"):
>"firefox"

[✔] App Saved Successfully

➕ Add Multiple Command

$ appmanager add

ID :
>2

Title :
>Git

Commands (enclose each command in double quotes. Single quotes are allowed inside double quotes. Example: "A" "B" "C" "D 'd'"):
>"git status" "git add ." "git branch -M main" "git commit -m'demo commit'" "git push origin main"

[✔] App Saved Successfully

▶ See the App and Run App via ID

$ appmanager

[1] Firefox
[2] Git

>1

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

▶ Run App via ID

$ appmanager run 2

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

📋 To See the App List

$ appmanager list

+----+---------+---------------------------------------------------------------------------------------------+
| No | Title   | Command                                                                                     |
+----+---------+---------------------------------------------------------------------------------------------+
| 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 via ID

$ appmanager delete 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 -c

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.