diff --git a/docs/images/aldermon.png b/docs/images/aldermon.png
new file mode 100644
index 0000000..98a0ef0
Binary files /dev/null and b/docs/images/aldermon.png differ
diff --git a/docs/images/aldermon_settings.png b/docs/images/aldermon_settings.png
new file mode 100644
index 0000000..dffd821
Binary files /dev/null and b/docs/images/aldermon_settings.png differ
diff --git a/readme.md b/readme.md
index 04c6a4e..85dfd9a 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,12 @@
 ## Alder Lake Tools
 
-Simple vCore monitoring and bench utilities for Intel 12th gen. Probably works for other machines, but I have a 12600K so that's what it's made for. 
+Simple vCore monitoring and bench utilities for Intel 12th gen. Made because I couldn't find a utility to graph vCore while overclocking my CPU. Probably works for other machines, but I have a 12600K so that's what it's made for. Built with opencode, mostly Qwen3.8 models and GLM.
+
+## aldermon
+<img src="docs/images/aldermon.png" width=600>
+
+Live activity bars for the core clocks/temps, and graphing for vCore, Clock, Power Draw, Temp. Makes it easy to see when voltage spikes and how it relates to clock/power/temp, so you can understand the load the CPU is under. Also tracks peaks. 
+
+<img src="docs/images/aldermon_settings.png" width=400>
+
+Hit F2 for settings, F10 to save (similar to htop).