From ce67d7a3c4ccb3bcfe07884df317433c7283b48e Mon Sep 17 00:00:00 2001
From: P7MJ <p7mj@wholeworldcoding.com>
Date: Tue, 9 Jun 2026 19:47:37 -0400
Subject: [PATCH] Update README.md

---
 README.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 69 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a32d819..c9095d8 100644
--- a/README.md
+++ b/README.md
@@ -24,4 +24,72 @@ Download the distribution you are interested in using from the release page. The
 
 Once you have extracted the files, run `python3 fdea-1.py`. You will be prompted with a password. The default is `hello`.
 
-BUGPy's commands are based on *NIX commands. If you are comfortable in a Linux terminal, you will be able to use BUGPy.
\ No newline at end of file
+BUGPy's system utilities are based on *NIX commands. If you are comfortable with Linux terminals, you will be able to use BUGPy. Help sections for each command are availible by running `<command> -h` or `<command> --help`.
+
+## 🔒 Encryption w/FDEA
+
+**FDEA** stands for the **Full Disk Encryption Ant**. It is a utility that acts as the encryption/decryption agent and the launcher for BUGPy.
+
+It uses an adapted version of `PCS` ([link](https://git.wholeworldcoding.com/p7mj/PCS)) to handle the encryption and decryption of the main system folder. The entire folder is encrypted as one into `cat1_enc.p7c_enc` using your password.
+
+> ⚠️ **If you lose your password, there is no way to recover the contents of the BUGPy installation.**
+
+## 🔤 Terminology
+
+`cat` (catepillar): a BUGPy drive.
+
+`ant`: any script that assists BUGPy but is not found in the scripts folder
+
+`pointerfile`: a txt file that contains aliases and the scripts they point to
+
+`bpm` (BUGS Package Manager): the default package manager for BUGPy.
+
+`bush` (BUGS-Shell): the default command interpreter and shell for BUGPy.
+
+`fdea` (Full Disk Encryption Ant): the default encryption/decryption and launcher for BUGPy.
+
+## 🏗️ Structure
+
+A BUGPy-mOS A-4-i `std` install looks like this:
+
+```
+cat1
+├── bugpy-mos-1.py
+├── bush.py
+├── config
+│   ├── log.txt
+│   ├── p7mj_retardedness.txt
+│   ├── pointerfile.txt
+│   ├── startup.txt
+│   └── username.txt
+├── dev
+│   ├── changelog.txt
+│   ├── help_format.txt
+│   └── what_next.txt
+├── history
+│   └── history.txt
+├── home
+├── scripts
+│   ├── ... (system utilities)
+└── temp
+```
+
+## ⚙️ Configuration
+
+As intended, **almost every aspect of BUGPY-mOS is customizable**.
+
+For starters, you can change your username simply by editing `config/username.txt`! This will change your username as displayed in `bush`. You can also change any of the command/script aliases easily by editing the pointerfile.
+
+You can also make your own shell (although our shell is awesome) and rename it to bush.py.
+
+You can make your own apps, scripts, and packages for BUGPy-mOS! Read the [Wiki](https://git.wholeworldcoding.com/wholeworldcoding/BUGPy-mOS/wiki) for more information.
+
+## 🔧 Developers
+
+### Core Developers
+
+- **P7MJ**: Creator of BUGPy-mOS. Made all versions from `BUGPy-mOS-0` to `BUGPy-mOS-1 A-3-ii`.
+
+- **SpyDrone**: Creator of over half of the system utilities, `drone_game`, and most of the packages in `ext`.
+
+- **OctoLinkYT**: Creator of `octuple`. Founder of the `wholeworldcoding` group.
\ No newline at end of file