docs: Updated readme

readme.md

@@ -6,17 +6,22 @@ The goal is simple: reduce the number of manual steps required after installing
 
 ## Available Scripts
 
-| Script            | Description                                                           |
-| ----------------- | --------------------------------------------------------------------- |
-| `install_agy.sh`  | Installs Antigravity CLI and triggers native shell configuration.     |
-| `install_bat.sh`  | Installs Bat (alternative to cat) and configures alias.               |
-| `install_node.sh` | Installs Node.js (LTS) and NVM (Node Version Manager).                 |
-| `install_nvim.sh` | Installs Neovim 0.11.7 and clones my Neovim configuration repository. |
-| `install_rust.sh` | Installs Rust (rustup) and configures cargo environment.               |
-| `install_yazi.sh` | Installs Yazi terminal file manager and its dependencies.             |
-| `install_zoxide.sh` | Installs Zoxide directory jumper and configures shell integrations.   |
+Bootstrap is designed to be completely **environment-agnostic** and self-contained. Each bootstrap script automatically detects your platform (supporting Arch Linux, Debian/Ubuntu, Fedora, etc.) and architecture, installs the necessary dependencies using the native package manager or verified binary downloads, and cleanly configures your shell environment. This removes the overhead of maintaining multi-platform scripts and eliminates the need to run raw, complex pipelines from the web.
 
-All scripts support Arch Linux, Debian / Ubuntu, and Fedora.
+Here is a comparison of the size and complexity of using Bootstrap (`to b`) versus running the original, official installation scripts (`not to b`):
+
+| application | to b | not to b |
+| :--- | :--- | :--- |
+| **Antigravity CLI (`agy`)** | 197 lines | N/A (Official binary distribution) |
+| **Bat (`bat`)** | 155 lines | N/A (Standard package install) |
+| **Node.js & NVM (`node`)** | 156 lines | 507 lines (Official NVM install script) |
+| **Neovim (`nvim`)** | 178 lines | N/A (Official binary/config distribution) |
+| **PNPM (`pnpm`)** | 245 lines | 213 lines (Official get.pnpm.io script) |
+| **Rust (`rust`)** | 155 lines | 921 lines (Official sh.rustup.rs script) |
+| **Starship (`starship`)** | 132 lines | 554 lines (Official starship.rs script) |
+| **Yay (`yay`)** | 96 lines | N/A (Official manual build process) |
+| **Yazi (`yazi`)** | 163 lines | N/A (Standard package install) |
+| **Zoxide (`zoxide`)** | 90 lines | 466 lines (Official zoxide install script) |
 
 More scripts will be added over time.
 
@@ -98,7 +103,14 @@ Potential additions include:
 
 Running scripts directly from the internet is convenient but should always be approached with caution.
 
-If you do not trust the source, inspect the script before executing it:
+### Why Bootstrap is More Secure
+Instead of blindly piping large, third-party installation scripts (often hundreds or thousands of lines of unscrutinized code) directly from the internet into your shell, Bootstrap uses a **scrutinized and simplified** approach:
+
+1. **Audited & Minimised**: Every script in `installers/` has been scrutinized, refactored, and stripped of redundant compatibility layers (like Windows/macOS support or complex environment checks), leaving only the essential, readable logic required for your setup.
+2. **Controlled Execution**: Since installer scripts are hosted locally in your cloned repository, you can review every line of code before executing it. You are never subject to silent, upstream changes to installers.
+3. **No Raw Pipes**: We download official binary releases directly to verified temporary locations rather than running arbitrary third-party script pipelines.
+
+If you want to audit the core Bootstrap CLI itself before running it:
 
 ```bash
 curl -fsSL https://git.adityagupta.dev/sortedcord/bootstrap/raw/branch/master/bootstrap.sh