docs: update README

2 files changed, 12 insertions, 2 deletions

diff --git a/README.md b/README.md
index 4db763e..66ab231 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,19 @@
-> [!warning] Warning
+> [!warning]
 > This project is still a work-in-progress. There may be bugs and missing features.
 
+![](demo.gif)
+
 # wthis
 
-A CLI tool to fetch information about a Homebrew formulae or cask.
+A CLI tool to fetch information about a Homebrew formulae or cask. `wthis` stands for "What the heck is ...?"
+
+## Installation
+
+```shell
+brew install eltrac/wthis/wthis
+```
+
+## Usage
 
 ```shell
 wthis <package-name>
diff --git a/demo.gif b/demo.gif
new file mode 100644
index 0000000..ac33fa4
--- /dev/null
+++ b/demo.gif