diff --git a/README.md b/README.md
index a5be7be..65d865d 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,25 @@ Legend:
 | YubiKey support                                                                 | ❌             | ✅                                   | ❌             |
 | Automatic keychain discovery                                                    | ✅             | ✅                                   | ✅             |
 
+# Quickstart
+
+```bash
+# create a keychain
+pw init ~/secrets.keychain-db
+
+# configure keychains in ~/.pwrc
+echo 'PW_KEYCHAINS=(~/secrets.keychain-db)' > ~/.pwrc
+
+# add an entry
+pw add GitHub sschmid
+
+# copy the password
+pw GitHub
+
+# print the password using fzf
+pw -p
+```
+
 # Usage
 
 In all following examples, `[<args>]` refers to the optional