diff --git a/projects/github.com/zsh-users/zsh-autosuggestions/README.md b/projects/github.com/zsh-users/zsh-autosuggestions/README.md
new file mode 100644
index 00000000..5436900b
--- /dev/null
+++ b/projects/github.com/zsh-users/zsh-autosuggestions/README.md
@@ -0,0 +1,5 @@
+To activate the autosuggestions, add the following at the end of your .zshrc:
+
+source $ZSH_AUTOSUGGESTIONS_ROOT/share/zsh-autosuggestions/zsh-autosuggestions.zsh
+
+You will also need to restart your terminal for this change to take effect.
\ No newline at end of file
diff --git a/projects/github.com/zsh-users/zsh-autosuggestions/package.yml b/projects/github.com/zsh-users/zsh-autosuggestions/package.yml
new file mode 100644
index 00000000..a94e27de
--- /dev/null
+++ b/projects/github.com/zsh-users/zsh-autosuggestions/package.yml
@@ -0,0 +1,26 @@
+distributable:
+  url: https://github.com/zsh-users/zsh-autosuggestions/archive/{{version.tag}}.tar.gz
+  strip-components: 1
+
+versions:
+  github: zsh-users/zsh-autosuggestions/tags
+
+warnings:
+  - vendored
+
+runtime:
+  ZSH_AUTOSUGGESTIONS_ROOT: ${{prefix}}
+
+build:
+  install -D zsh-autosuggestions.zsh {{prefix}}/share/zsh-autosuggestions/zsh-autosuggestions.zsh
+
+test:
+  - run: zsh $FIXTURE | grep zsh-autosuggestions
+    fixture:
+      contents: |
+        fpath=($ZSH_AUTOSUGGESTIONS_ROOT/share $fpath)
+        autoload -Uz compinit
+        compinit
+        autoload -Uz zsh-autosuggestions
+        which zsh-autosuggestions
+      extname: zsh