diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bdc95de
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Eko
+
+<p>
+    <picture>
+      <img width="768" height="192" alt="eko-banner" src="https://github.com/user-attachments/assets/6126da2a-9b46-41c8-9eac-84319ecddb84" />
+    </picture>
+    <br>
+    <a href="https://github.com/charmbracelet/bubbletea/releases"><img src="https://img.shields.io/github/release/charmbracelet/bubbletea.svg" alt="Latest Release"></a>
+</p>
+
diff --git a/assets/eko-banner.png b/assets/eko-banner.png
new file mode 100644
index 0000000..1d1c0aa
Binary files /dev/null and b/assets/eko-banner.png differ
diff --git a/assets/eko-screenshot.png b/assets/eko-screenshot.png
new file mode 100644
index 0000000..f30fa24
Binary files /dev/null and b/assets/eko-screenshot.png differ