penguins-eggs 25.12.7 → 25.12.15

package/.oclif.manifest.json

@@ -1570,5 +1570,5 @@
       ]
     }
   },
-  "version": "25.12.7"
+  "version": "25.12.15"
 }

package/README.md

@@ -62,13 +62,13 @@ Lightweight and Distro-Agnostic: It works across various Debian, Devuan, Ubuntu,
 [![penguins-eggs as AppImage](https://img.shields.io/badge/Get%20it%20as-AppImage-important.svg)](https://github.com/pieroproietti/penguins-eggs/releases)
 
 
-Although penguins-eggs has only recently been released as an AppImage, it is perhaps the simplest method. All you need is to get the penguins-eggs AppImage: open a browser at the url: `https://github.com/pieroproietti/penguins-eggs`, on the right side, find `latest release`, download the AppImage `penguins-eggs-25.x.x-1-x86_64.AppImage` and launch it using `sudo`
+Although penguins-eggs has only recently been released as an AppImage, this is perhaps the simplest method. All you need is to get the penguins-eggs AppImage: open a browser at the url: `https://github.com/pieroproietti/penguins-eggs`, on the right side, find `latest release`, download the AppImage `penguins-eggs-25.x.x-1-x86_64.AppImage` and launch it using `sudo`
 
-The AppImage will be be automatically configured and renamed as `/usr/bin/eggs`. It's ready to use! 
+The AppImage will be automatically configured and renamed as `/usr/bin/eggs`. It's ready to use! 
 
 `eggs love` to get your system remastered as live ISO.
 
-## Before to try AppImage depending on your distro, you need this packages installed:
+## Before trying the AppImage, depending on your distro, you need to install these packages:
 * Alpine: `sudo apk add fuse`
 * Arch/Manjaro: `sudo pacman -S fuse2`
 * Debian/Devuan/Ubuntu: `sudo apt-get install fuse libfuse2`
@@ -101,13 +101,17 @@ sudo ./fresh-eggs.sh
 ```
 And follow instructions.
 
+### using Eggo - The Simpler Installer for Penguins Eggs
+From our friend [Brickboss](https://github.com/robert19066) come [eggo](https://github.com/robert19066/Eggo) a simple installer for penguins-eggs. [Instructions](https://github.com/robert19066/Eggo).
+
+
 ### Manual installation
 
 ### AlmaLinux, RockyLinux
 Since penguins-eggs-25.7.14 rpm packages for Enterprise Linux [el9](https://penguins-eggs.net/basket/index.php/packages/el9) are availables.
 
 ### AlpineLinux
-I created and maintain a package for Alpine. Its repository is [penguins-alpine](https://github.com/pieroproietti/penguins-alpine) and related packages can be downloaded from  [penguins-eggs.net](https://penguins-eggs.net/basket/index.php/packages/alpine) or the [sourceforge page](https://sourceforge.net/projects/penguins-eggs/files/Packages/alpine/).
+I maintain a package for Alpine Linux. Its repository is [penguins-alpine](https://github.com/pieroproietti/penguins-alpine) and related packages can be downloaded from  [penguins-eggs.net](https://penguins-eggs.net/basket/index.php/packages/alpine) or the [sourceforge page](https://sourceforge.net/projects/penguins-eggs/files/Packages/alpine/).
 
 ### Arch
 Just download and install penguins-eggs-25.x.x using [fresh-eggs](https://github.com/pieroproietti/fresh-eggs).
@@ -241,25 +245,50 @@ Furthermore, addons, predominantly themes, have been organized under the vendor'
 > For detailed instructions on using a wardrobe, please consult the wardrobe users' guide  [wardrobe users' guide](https://penguins-eggs.net/docs/Tutorial/wardrobe-users-guide).
 
 
-## Clone/Cryptedclone
-When creating a live distribution of your system, you have different options to consider: the default mode, clone, and cryptedclone.
-•	The default mode, achieved by using the command `eggs produce`, completely removes user data from the live distribution. This ensures that no private data remains in the live system.
- 
-•	The `eggs produce --clone` command allows you to save both user data and system data directly in the generated ISO. This means that if someone obtains a copy of the ISO, they will be able to see and access the 
-user data directly from the live system. It's important to note that this data is not encrypted, so it may not be suitable if you have sensitive information on your system.
- 
-•	On the other hand, the `eggs produce --cryptedclone` command saves the data within the generated ISO using a LUKS (Linux Unified Key Setup) volume. With this option, the user data will not be visible in the live system. However, it can be automatically reinstalled during the system installation process using the "krill" installer. Even if someone has the generated ISO, they won't be able to access the user data without the LUKS passphrase. This ensures that your data remains protected.
+## System Cloning and Data Handling
+When creating a live distribution of your system using eggs produce, you must decide how to handle user data. You have three primary approaches: Default (Clean), Direct Clone, and Encrypted Clone.
 
-To summarize the available options:
+### 1. Default Mode (Clean System)
+Command: `eggs produce`
 
-•	`eggs produce` (default): All private data is removed from the live system.
+This is the default mode. It completely removes all user data and personal settings from the live distribution.
 
-•	`eggs produce --clone`: All user data is included unencrypted directly in the live system.
+Best for: Creating a distributable ISO to share with others or creating a clean "factory reset" image.
 
-•	`eggs produce --cryptedclone`: All user data is included encrypted within a LUKS volume inside the ISO.
-> [!TIP]
->    During the installation process, you can use the "krill" installer to restore your crypted data automatically. By running the command "sudo eggs install" with the "krill" installer, your encrypted data will be securely transferred and made available in the installed system.
+Privacy: Maximum. No private data remains in the live system.
+
+### 2. Clone (Unencrypted)
+Command: `eggs produce --clone`
+
+This command creates an exact replica of your current system, saving both system files and user data directly into the ISO.
+
+Behavior: If someone obtains this ISO, they can boot it and immediately access your files, browsing history, and settings without a password.
+
+Best for: Personal backups where the physical media (USB/DVD) remains in your secure possession.
+
+Privacy Warning: Low. Data is not encrypted. Do not share this ISO publicly if it contains sensitive information.
+
+### 3. Encrypted Clone (Secure Backup)
+Commands: `eggs produce --homecrypt` / `eggs produce --fullcrypt`
+
+These options save your data within the ISO but protect it inside a LUKS (Linux Unified Key Setup) volume.
+
+Behavior: Your user data is included but is not visible or accessible in the live system session. Even if a third party obtains the ISO, they cannot access the data without the LUKS passphrase.
+
+Best for: Secure backups or transporting your environment across different machines.
+
+> [NOTE] Availability and Scope
+
+> eggs produce --homecrypt: Available for most distributions using either native penguins-eggs packages or the AppImage. It protects sensitive data under /home and system accounts.
+
+> `eggs produce --fullcrypt`: Supported only on Debian Trixie and Devuan Excalibur, and exclusively when using native eggs packages. Unlike homecrypt, this option does not limit protection to /home, but encrypts the entire system.
 
+| Command | Data Included? | Encryption | Visible on Live System? | Use Case |
+| :--- | :--- | :--- | :--- | :--- |
+| `eggs produce` | No | N/A | No | Public Distribution / Clean Install |
+| `eggs produce --clone` | **Yes** | No | **Yes** | Personal Unsecured Backup |
+| `eggs produce --homecrypt` | **Yes** (/home) | **Yes (LUKS)** | Yes | Secure Backup of User Data |
+| `eggs produce --fullcrypt` | **Yes** (Full) | **Yes (LUKS)** | Yes | Maximum Security Backup (Debian/Devuan only) |
 
 ## Calamares and krill
  Calamares and Krill are powerful tools in the Eggs project, [calamares](https://calamares.io), offering versatile installation options for Linux systems. The Eggs project was specifically designed to utilize Calamares as the default system installer, providing users with the flexibility to customize their installations using themes. However, Eggs goes beyond Calamares by introducing its own installer called Krill, which focuses on command-line interface (CLI) installations, particularly for server environments.
@@ -563,7 +592,7 @@ EXAMPLES
   $ eggs adapt
 ```
 
-_See code: [src/commands/adapt.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/adapt.ts)_
+_See code: [src/commands/adapt.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/adapt.ts)_
 
 ## `eggs autocomplete [SHELL]`
 
@@ -627,7 +656,7 @@ EXAMPLES
   sudo eggs calamares --remove
 ```
 
-_See code: [src/commands/calamares.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/calamares.ts)_
+_See code: [src/commands/calamares.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/calamares.ts)_
 
 ## `eggs config`
 
@@ -654,7 +683,7 @@ EXAMPLES
   sudo eggs config --clean --nointeractive
 ```
 
-_See code: [src/commands/config.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/config.ts)_
+_See code: [src/commands/config.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/config.ts)_
 
 ## `eggs cuckoo`
 
@@ -675,7 +704,7 @@ EXAMPLES
   sudo eggs cuckoo
 ```
 
-_See code: [src/commands/cuckoo.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/cuckoo.ts)_
+_See code: [src/commands/cuckoo.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/cuckoo.ts)_
 
 ## `eggs dad`
 
@@ -704,7 +733,7 @@ EXAMPLES
   sudo dad --default
 ```
 
-_See code: [src/commands/dad.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/dad.ts)_
+_See code: [src/commands/dad.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/dad.ts)_
 
 ## `eggs export appimage`
 
@@ -730,7 +759,7 @@ EXAMPLES
   $ eggs export pkg --all
 ```
 
-_See code: [src/commands/export/appimage.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/export/appimage.ts)_
+_See code: [src/commands/export/appimage.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/export/appimage.ts)_
 
 ## `eggs export iso`
 
@@ -755,7 +784,7 @@ EXAMPLES
   $ eggs export iso --clean
 ```
 
-_See code: [src/commands/export/iso.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/export/iso.ts)_
+_See code: [src/commands/export/iso.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/export/iso.ts)_
 
 ## `eggs export pkg`
 
@@ -782,7 +811,7 @@ EXAMPLES
   $ eggs export pkg --all
 ```
 
-_See code: [src/commands/export/pkg.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/export/pkg.ts)_
+_See code: [src/commands/export/pkg.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/export/pkg.ts)_
 
 ## `eggs export tarballs`
 
@@ -806,7 +835,7 @@ EXAMPLES
   $ eggs export tarballs --clean
 ```
 
-_See code: [src/commands/export/tarballs.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/export/tarballs.ts)_
+_See code: [src/commands/export/tarballs.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/export/tarballs.ts)_
 
 ## `eggs help [COMMAND]`
 
@@ -849,7 +878,7 @@ EXAMPLES
   sudo eggs kill
 ```
 
-_See code: [src/commands/kill.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/kill.ts)_
+_See code: [src/commands/kill.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/kill.ts)_
 
 ## `eggs krill`
 
@@ -890,7 +919,7 @@ EXAMPLES
   sudo eggs install --chroot
 ```
 
-_See code: [src/commands/krill.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/krill.ts)_
+_See code: [src/commands/krill.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/krill.ts)_
 
 ## `eggs love`
 
@@ -916,7 +945,7 @@ EXAMPLES
   $ eggs auto
 ```
 
-_See code: [src/commands/love.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/love.ts)_
+_See code: [src/commands/love.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/love.ts)_
 
 ## `eggs mom`
 
@@ -936,7 +965,7 @@ EXAMPLES
   $ eggs mom
 ```
 
-_See code: [src/commands/mom.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/mom.ts)_
+_See code: [src/commands/mom.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/mom.ts)_
 
 ## `eggs produce`
 
@@ -989,7 +1018,7 @@ EXAMPLES
   sudo eggs produce --basename=colibri
 ```
 
-_See code: [src/commands/produce.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/produce.ts)_
+_See code: [src/commands/produce.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/produce.ts)_
 
 ## `eggs setup install`
 
@@ -1010,7 +1039,7 @@ EXAMPLES
   sudo eggs setup purge                # purge all configurations, autocomplete, man, etc installed from penguins-eggs AppImage
 ```
 
-_See code: [src/commands/setup/install.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/setup/install.ts)_
+_See code: [src/commands/setup/install.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/setup/install.ts)_
 
 ## `eggs setup purge`
 
@@ -1031,7 +1060,7 @@ EXAMPLES
   sudo eggs setup purge                # purge all configurations, autocomplete, man, etc installed from penguins-eggs AppImage
 ```
 
-_See code: [src/commands/setup/purge.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/setup/purge.ts)_
+_See code: [src/commands/setup/purge.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/setup/purge.ts)_
 
 ## `eggs status`
 
@@ -1052,7 +1081,7 @@ EXAMPLES
   $ eggs status
 ```
 
-_See code: [src/commands/status.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/status.ts)_
 
 ## `eggs tools clean`
 
@@ -1074,7 +1103,7 @@ EXAMPLES
   sudo eggs tools clean
 ```
 
-_See code: [src/commands/tools/clean.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/tools/clean.ts)_
+_See code: [src/commands/tools/clean.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/tools/clean.ts)_
 
 ## `eggs tools repo`
 
@@ -1100,7 +1129,7 @@ EXAMPLES
   sudo eggs tools repo --remove
 ```
 
-_See code: [src/commands/tools/repo.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/tools/repo.ts)_
+_See code: [src/commands/tools/repo.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/tools/repo.ts)_
 
 ## `eggs tools skel`
 
@@ -1124,7 +1153,7 @@ EXAMPLES
   sudo eggs tools skel --user user-to-be-copied
 ```
 
-_See code: [src/commands/tools/skel.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/tools/skel.ts)_
+_See code: [src/commands/tools/skel.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/tools/skel.ts)_
 
 ## `eggs tools stat`
 
@@ -1150,7 +1179,7 @@ EXAMPLES
   $ eggs tools stat --year
 ```
 
-_See code: [src/commands/tools/stat.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/tools/stat.ts)_
+_See code: [src/commands/tools/stat.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/tools/stat.ts)_
 
 ## `eggs tools yolk`
 
@@ -1171,7 +1200,7 @@ EXAMPLES
   sudo eggs tools yolk
 ```
 
-_See code: [src/commands/tools/yolk.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/tools/yolk.ts)_
+_See code: [src/commands/tools/yolk.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/tools/yolk.ts)_
 
 ## `eggs update`
 
@@ -1192,7 +1221,7 @@ EXAMPLES
   $ eggs update
 ```
 
-_See code: [src/commands/update.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/update.ts)_
+_See code: [src/commands/update.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/update.ts)_
 
 ## `eggs version`
 
@@ -1238,7 +1267,7 @@ EXAMPLES
   $ eggs wardrobe get your-wardrobe
 ```
 
-_See code: [src/commands/wardrobe/get.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/wardrobe/get.ts)_
+_See code: [src/commands/wardrobe/get.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/wardrobe/get.ts)_
 
 ## `eggs wardrobe list [REPO]`
 
@@ -1267,7 +1296,7 @@ EXAMPLES
   $ eggs wardrobe list --distro arch
 ```
 
-_See code: [src/commands/wardrobe/list.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/wardrobe/list.ts)_
+_See code: [src/commands/wardrobe/list.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/wardrobe/list.ts)_
 
 ## `eggs wardrobe show [REPO]`
 
@@ -1297,7 +1326,7 @@ EXAMPLES
   $ eggs wardrobe show accessories/
 ```
 
-_See code: [src/commands/wardrobe/show.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/wardrobe/show.ts)_
+_See code: [src/commands/wardrobe/show.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/wardrobe/show.ts)_
 
 ## `eggs wardrobe wear [REPO]`
 
@@ -1328,7 +1357,7 @@ EXAMPLES
   sudo eggs wardrobe wear wagtail/waydroid
 ```
 
-_See code: [src/commands/wardrobe/wear.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.7/src/commands/wardrobe/wear.ts)_
+_See code: [src/commands/wardrobe/wear.ts](https://github.com/pieroproietti/penguins-eggs/blob/v25.12.15/src/commands/wardrobe/wear.ts)_
 <!-- commandsstop -->
 
 # GUI