diff --git a/README.md b/README.md
index 713a2fc88..266cb2cde 100644
--- a/README.md
+++ b/README.md
@@ -7,10 +7,16 @@ diffr is a Rust-based structural diffing (AST-aware) library. It is also package
 ## Features
 
 1. Interactive TUI with AST-aware code folding
-3. Sane defaults for AI coding
-  - Summarize long changes as pseudocode
-  - Collapse tests and docs
-3. WASM-based plugin system
+
+   ![AST-aware code folding in the diffr TUI](docs/images/folding.gif)
+
+2. Sane defaults for AI coding
+   - Summarize long changes as pseudocode
+   - Collapse tests and docs
+
+   ![Long changes summarized as pseudocode in the diffr TUI](docs/images/pseudocode.gif)
+
+3. [WASM-based plugin system](docs/plugin.md)
 
 ## Usage
 
diff --git a/docs/images/folding.gif b/docs/images/folding.gif
new file mode 100644
index 000000000..9061c39b3
Binary files /dev/null and b/docs/images/folding.gif differ
diff --git a/docs/images/pseudocode.gif b/docs/images/pseudocode.gif
new file mode 100644
index 000000000..b54ac7210
Binary files /dev/null and b/docs/images/pseudocode.gif differ