diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c954ab4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Scripts for STM32
+
+**...and other stuff probably**
+
+## Configs
+* `.editorconfig` - editor config [for most popular editors](https://editorconfig.org/#pre-installed), copies the ugly style of STM32's generated projects so you don't have messy mismatched code in vim, emacs, vscode et al
+* `fixbear.sh` - After running `bear -- make` in a project, some LSP clients freak out. This helps.
+* `stm32-uart.sh` - Shortcut to run `minicom -D /dev/tty/ACM0` for STM32's USB UART output. You need `minicom` for this. Press `Ctrl+a` and then `q` to exit.