diff --git a/README.md b/README.md
index 7851bc5..66912d8 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,10 @@ The keybindings for the completions are as follows:
 
 Keybinds can be customized by modifying the `$HOME/.config/fish/functions/based_user_key_bindings.fish` file.
 
+## Demonstration
+
+![based.fish demonstration](assets/based_fish_plugin.gif)
+
 ## Contributing
 
 If you want to contribute to based.fish, feel free to open issues or pull requests on the GitHub repository. Contributions are welcome!
diff --git a/assets/based_fish_plugin.gif b/assets/based_fish_plugin.gif
new file mode 100644
index 0000000..e946b1b
Binary files /dev/null and b/assets/based_fish_plugin.gif differ