diff --git a/README.md b/README.md
index 38382f8..69d39fa 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,25 @@ also some install scripts for stuff like `paru`
 
 oh yeah also it has a (kind of) a package manager which is called `brick.sh` which is used to install some stuff
 
+# installation
+so this repo serves as both the OS and its package registry.  
+to install it, clone the repo and cd to it:
+
+```sh
+git clone https://git.blek.codes/blek/os bos
+cd bos
+```
+
+now after you have done that, you will have a `brick.sh` in your working directory and you can install stuff !! ^=^
+
+to do this, run this:
+```sh
+./brick.sh package1 package2 # list of packages is a bit down
+```
+
+# packages
+ok so for now there arent a lot (probably wont be lmao) but theres the ones that are there:
+1. `omz` - a cool shell framework
+2. `nvim` - like vim but better + has my "rice"
+
 ## have fun ^^