diff --git a/README.md b/README.md
index f2e5807..61f9954 100644
--- a/README.md
+++ b/README.md
@@ -553,6 +553,17 @@ pyspector scan ./my-python-project --supply-chain
 
 </details>
 
+<details>
+<summary>How do I enable debug output?</summary>
+
+Use `--debug` to print verbose internal details during analysis, which is useful for troubleshooting false positives or unexpected results:
+
+```bash
+pyspector scan ./my-python-project --debug
+```
+
+</details>
+
 <details>
 <summary>How can I integrate PySpector into CI?</summary>