diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2fce928
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# OS161 assignments
+
+This is my assignments I submitted for my CSE4001 course.
+
+## My additions
+- [clang-format](https://clang.llvm.org/docs/ClangFormat.html)ted the repo so it looks nice
+- `/helper_scripts`: collection of scripts I used to build and manage the repo
+  - `build_os.sh`: point this script to a os161 source tree and it will copy it and make a new clean build
+  - `build_sys.sh`: builds sys161 (not used)
+  - `clang-format-helper`: formats a directory and creates a `.clang-format` with needed additions
+
+## Branches
+- `main`: primary branch for anything non-assignment specific
+- `ASST2/add-syscall`: adds a `sys_hello` syscall and a `hellotest` binary