ForgeX CLI ⚙️

A powerful, cross-distro command-line utility built for Linux power users and system maintainers.
Designed by the ForgeX Foundation, this tool helps you manage system info, packages, cleanup, and more, all from one binary.

---

🚀 Features

• 🧩 One binary, works across Debian, Arch, Fedora, Void, openSUSE, NixOS
• 🔁 fx update — System update for your distro
• 🧠 fx info — System summary (CPU, RAM, uptime)
• 🛑 fx kill <port> — Kill process running on a specific port
• 🧼 fx clean — Clean system cache & junk
• 🌐 fx ports — List open listening ports
• 🔄 fx update --self — Self-update from GitHub
• 🧹 fx uninstall — Completely uninstall ForgeX CLI
• ⚙️ Reads user config from ~/.fxconfig
• 🆘 fx help — Full list of commands

---

📦 Installation

1. Clone the repo

git clone https://github.com/ForgeX-Foundation/forgex-cli.git
cd forgex-cli

2. Build and Install

mkdir -p build && cd build
cmake ..
make
sudo make install

🧪 This installs:

• Binary: /usr/local/bin/fx
• Scripts: /usr/local/share/forgex-cli/

---

🧪 Usage

fx help             # Show help menu
fx info             # System info
fx update           # Update your Linux system
fx update --self    # Update the ForgeX CLI binary
fx kill 3000        # Kill process on port 3000
fx ports            # Show open ports
fx clean            # Clean junk files
fx uninstall        # Uninstall ForgeX CLI

---

⚙️ Configuration

ForgeX CLI reads settings from:

~/.fxconfig

Example contents:

theme=dark
autoupdate=true

This is auto-generated on first run if missing.

---

🤝 Contributing

Pull requests are welcome! If you have ideas for scripts, improvements, or distro support — join the ForgeX Foundation and contribute to building better Linux tooling.

---

📄 License

MIT License © 2025 ForgeX Foundation