diff --git a/docs/reference/cli/pipeline/exec.md b/docs/reference/cli/pipeline/exec.md
index f1a6ea5..e6aeb08 100644
--- a/docs/reference/cli/pipeline/exec.md
+++ b/docs/reference/cli/pipeline/exec.md
@@ -5,6 +5,10 @@ description: >
   Learn how to execute a pipeline locally.
 ---
 
+:::note
+This command runs the pipeline locally on the machine where it is executed — it does not trigger a run on the remote Vela platform.
+:::
+
 ## Command
 
 ```