Axec-cli Appimage Executor

A blazing-fast CLI tool to list and launch AppImages on Arch Linux (will work on other distros)

---

🚀 Features

• ⚡ List AppImages in specified directory (Default : ~/AppImages)
• 🏃‍♂️ Run AppImages with a single command
• 🧠 Smart fallback to default AppImage folder
• ✨ Built with Node.js + Commander.js
• 💻 Designed for Arch + KDE but works on any distro

---

📦 Installation

sudo npm install -g axec-cli

or use with npx

npx axec-cli

---

📂 AppImage Directory

By default, Axec-cli looks for AppImages in:

~/AppImages

You can also pass a full path to an AppImage if it's stored elsewhere.

---

🧪 Usage

List available AppImages

axec list

Run an AppImage from default folder

Example:

axec run filename.AppImage

Run an AppImage from a custom path

Example:

axec run ~/Downloads/filename.AppImage

---

🛠️ Commands

Command	Description
axec list [dir]	Lists all .AppImage files in the mentioned directory (Default: ~/AppImages)
axec run <filename>	Launches the AppImage file

---

🧱 Built With

• Node.js
• Commander.js
• Chalk

---

🧩 Coming Soon (v1.1+)/ To-Do

• ✅ Auto chmod +x on non-executable AppImages
• 🔍 Fuzzy matching for partial filenames
• 🧠 Config file support for custom AppImage folders
• 🖼️ GUI version for KDE
• 📦 AUR package?

---

🧑‍💻 Author

Made with ❤️ by Praneesh R V

---

📄 License

MIT License — feel free to fork and build on top.