diff --git a/tools/cds-cli.md b/tools/cds-cli.md
index 1bd640cde..d5960aae1 100644
--- a/tools/cds-cli.md
+++ b/tools/cds-cli.md
@@ -428,6 +428,24 @@ To customize the diagram layout, use these settings in the _Cds > Preview_ categ
 - [Diagram: Namespaces](vscode://settings/cds.preview.diagram.namespaces)
 - [Diagram: Queries](vscode://settings/cds.preview.diagram.queries)
 
+## cds watch
+
+Use `cds watch` to watch for changed files, restarting your server.
+
+::: details See the full help text of `cds watch`
+<!--@include: ./assets/help/cds-watch.out.md-->
+:::
+
+### Includes and Excludes <Since version="8.7.0" of="@sap/cds-dk" />
+
+Additional watched or ignored paths can be specified via CLI options:
+
+```sh
+cds watch --include ../other-app --exclude .idea/
+```
+
+Alternatively, you can add these paths through settings <Config keyOnly>cds.watch.include: ["../other-app"]</Config> and <Config keyOnly>cds.watch.exclude: [".idea"]</Config> to your project configuration.
+
 
 ## cds repl