diff --git a/README.md b/README.md
new file mode 100644
index 0000000..400ecd0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Rust Chrono LLDB Formatters
+
+## How to Use formatters/chrono.py
+
+### Raw lldb users
+Put contents under into ~/.lldbinit file, then use lldb to debug, it will automatically format chrono times
+
+```
+command script import ~/.lldb/chrono.py
+type summary add -F chrono.GetSummary chrono::datetime::DateTime<chrono::offset::utc::Utc>
+```
+### RustLLDB users
+
+In your `launch.json` file add the following line
+```
+"preRunCommands": [
+    "command source ~/.lldbinit"
+]
+```