diff --git a/README.md b/README.md
index 5a16fa9f..7b0a12f2 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,8 @@ Annotation-based Java command line parser. Usage help with ANSI colors. Autocomp
 
 |Now in BETA: [command line autocompletion](http://picocli.info/1.0.0-SNAPSHOT/autocomplete.html)|
 |----|
-|Autocomplete is work in progress. Comments, bug reports, pull requests welcome!|
+|Autocomplete is work in progress. Comments, bug reports, pull requests welcome!
+![Autocompletion demo animation](docs/images/picocli-autocompletion-demo.gif?raw=true)|
 
 A Java command line parsing framework in a single file, so you can include it _in source form_.
 This lets users run picocli-based applications without requiring picocli as an external dependency.
diff --git a/docs/autocomplete.adoc b/docs/autocomplete.adoc
index b40c8168..da3d6a91 100644
--- a/docs/autocomplete.adoc
+++ b/docs/autocomplete.adoc
@@ -27,6 +27,8 @@ In the case of multiple possible completions, the Unix shell will display all su
 with those few characters. The user can type more characters and press TAB again to see a new, narrowed-down
 list if the typed characters are still ambiguous, or else complete the subcommand or option.
 
+image:picocli-autocompletion-demo.gif[Autocompletion demo animation]
+
 == Command Line Completion Example
 Assume we have a link:index.html[picocli]-based command line application with link:index.html#_subcommands[subcommands],
 all of which have some link:index.html#_options_and_parameters[options]. Below is an example:
diff --git a/docs/images/picocli-autocompletion-demo.gif b/docs/images/picocli-autocompletion-demo.gif
new file mode 100644
index 00000000..270ca75e
Binary files /dev/null and b/docs/images/picocli-autocompletion-demo.gif differ