diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cd349db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# baalajimaestro's obsidian support scripts
+
+Scripts to help me use obsidian more effortlessly.
+
+There are 2 scripts in this repo
+
+The scripts assume they are cloned as a directory, and the obsidian folder that is supposed to be handled, is the parent.
+The scripts also assume that your parent directory has git set up properly.
+
+`encrypt.py` - Encrypts the entire obsidian repo, with ChaCha20, retaining folder structure, with the given keys, supplied via env vars, and pushes it to a backup git facility.
+`trigger.py` - This is more like a personal script, but all it does is, create a git tag in the current obsidian repo, push it ahead, and trigger a CI pipeline on another repo.