diff --git a/core/cli/upgrade.el b/core/cli/upgrade.el
index 56304476e..893012f41 100644
--- a/core/cli/upgrade.el
+++ b/core/cli/upgrade.el
@@ -10,12 +10,18 @@ following shell commands:
     git pull --rebase
     bin/doom clean
     bin/doom refresh
-    bin/doom update"
+    bin/doom update
+
+Switches:
+  -t/--timeout TTL   Seconds until a thread is timed out (default: 45)
+  --threads N        How many threads to use (default: 8)"
   (and (doom-upgrade doom-auto-accept
                      (or (member "-f" args)
                          (member "--force" args)))
        (doom-packages-update
         doom-auto-accept
+        (when-let (threads (cadr (member "--threads" args)))
+          (string-to-number threads))
         (when-let (timeout (cadr (or (member "--timeout" args)
                                      (member "-t" args))))
           (string-to-number timeout)))