diff --git a/docs/cli/run.md b/docs/cli/run.md
index 38a3eeacf335..a666d119999d 100644
--- a/docs/cli/run.md
+++ b/docs/cli/run.md
@@ -121,6 +121,16 @@ immediately in all matching packages with prefixed streaming output. This is the
 preferred flag for long-running processes over many packages, for instance, a
 lengthy build process.
 
+### --workspace-concurrency
+
+* Default: **4**
+* Type: **Number**
+
+Set the maximum number of tasks to run simultaneously. For unlimited concurrency
+use `Infinity`.
+
+You can set the `workpace-concurrency` as `<= 0` and it will use amount of cores of the host as: `max(1, (number of cores) - abs(workspace-concurrency))`
+
 ### --stream
 
 Stream output from child processes immediately, prefixed with the originating