Skip to content

Repository files navigation

Linux Post Install

🚀 Prepare your Linux development environment with confidence.

Linux Post Install is an open-source CLI designed to inspect, diagnose and prepare Linux machines for development.

Instead of blindly installing packages, the tool helps you understand your system first, discover available development tools and safely preview installation commands before making any changes.


✨ Features

  • 🔍 Detect Linux distribution
  • 📦 Detect available package managers
  • 🩺 Diagnose development environment
  • 🛠 Discover installed development tools
  • 👀 Preview installation commands safely
  • ✅ Interactive confirmation before execution
  • ⚡ Lightweight TypeScript CLI
  • ❤️ Open source

Current Commands

Command Description
info Display Linux distribution and package manager information
doctor Check whether essential development tools are installed
list List supported development tools and their availability
install <tool> Preview the installation command for a specific tool

Installation

Clone the repository:

git clone https://github.com/Rafa-MKR2/linux-post-install.git
cd linux-post-install

Install dependencies:

npm install

Build the project:

npm run build

Run locally:

node dist/index.js info

Usage

System Information

linux-post-install info

Example:

Linux Post Install

Distribution : Garuda Linux
Family       : Arch
Version      : rolling
Package Mgr  : pacman

Doctor

Check if your machine is ready for development.

linux-post-install doctor

Example:

Linux Post Install Doctor

System

✔ Distribution detected
✔ Package manager detected

Development Tools

✔ git
✔ curl
✔ wget
✖ docker
✖ java

Summary

Passed: 6
Failed: 2

List Available Tools

linux-post-install list

Example:

✔ git
✔ curl
✔ wget
✖ docker
✔ node
✖ java

Preview Installation

Generate the installation command without changing your system.

linux-post-install install git

Example:

Linux Post Install

Installing: git

Detected:

Distribution: Garuda Linux
Package Manager: pacman

Installation command:

sudo pacman -S git

Continue with installation? [y/N]

Nothing is executed.

The current version only generates the command that would be used. You'll be asked to confirm before any action is taken.

Skip Confirmation

Use the --yes flag to skip the confirmation prompt:

linux-post-install install git --yes

This is useful for scripting or when you want to see the preview without interaction.


Why?

Setting up a fresh Linux installation usually means searching documentation, remembering package names and manually installing dozens of tools.

Linux Post Install aims to simplify this workflow by providing a single CLI capable of:

  • inspecting your environment;
  • identifying missing tools;
  • suggesting installation commands;
  • preparing your machine for development.

Future versions will support complete installation profiles and automated setup while keeping the process transparent and safe.


Roadmap

v0.1

  • ✅ Linux distribution detection
  • ✅ Package manager detection
  • ✅ Development environment diagnostics
  • ✅ Tool catalog
  • ✅ Installation preview
  • ✅ Interactive confirmation

v0.2

  • ⏳ Automated tests
  • ⏳ GitHub Actions CI/CD
  • ⏳ JSON output
  • ⏳ Development profiles

v0.3

  • ⏳ Real package installation
  • ⏳ Package validation
  • ⏳ Rollback support

Tech Stack

  • TypeScript
  • Node.js
  • Commander.js
  • ESLint
  • Prettier

Contributing

Contributions are always welcome!

Whether it's fixing a typo, improving documentation, adding support for another Linux distribution or implementing a new feature, every contribution helps make the project better.

Feel free to open an Issue or submit a Pull Request.


License

This project is licensed under the MIT License.

See the LICENSE file for more information.


⭐ If you found this project useful, consider giving it a star on GitHub. It helps the project reach more developers and motivates future improvements.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages