From 1e367568e2746c69a5cf5586abade68d08ac54bb Mon Sep 17 00:00:00 2001
From: docs-bot <docs-bot@users.noreply.github.com>
Date: Sat, 11 Apr 2026 22:31:01 +0000
Subject: [PATCH] Document CLI debug output for failed uploads

---
 cli.mdx | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/cli.mdx b/cli.mdx
index 94386cf..d30777f 100644
--- a/cli.mdx
+++ b/cli.mdx
@@ -357,6 +357,23 @@ For more options and commands, use:
 corgea --help
 ```
 
+### Debug Mode
+
+To enable debug logs, set `CORGEA_DEBUG=1` before running a command.
+
+<CodeGroup>
+```bash MacOS/Unix
+CORGEA_DEBUG=1 corgea scan
+```
+
+```bash Windows (PowerShell)
+$env:CORGEA_DEBUG="1"
+corgea scan
+```
+</CodeGroup>
+
+When debug mode is enabled, failed upload requests now include the HTTP status and response body in debug output, which helps with troubleshooting.
+
 ## Release Notes
 
 For full release notes, please visit our [GitHub releases page](https://github.com/corgea/cli/releases).