diff --git a/.vscode/launch.json b/.vscode/launch.json
index 16e77e3823da4d6aa58bb8c233de14df44caf691..e94492a3a66723d8155d083e58ff7afe22c99119 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -4,20 +4,14 @@
     {
       "name": "Debug glab",
       "type": "go",
+      "mode": "debug",
       "request": "launch",
       "program": "${workspaceFolder}/cmd/glab",
-      "outputMode": "remote",
       "args": [
-        "${input:arguments}"
+        // enter the arguments here
+        // for example:
+        // "issue", "list", "--per-page", "10"
       ]
     }
   ],
-  "inputs": [
-    {
-      "id": "arguments",
-      "type": "promptString",
-      "description": "Enter arguments to pass to the program",
-      "default": ""
-    }
-  ]
-}
+}
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index fca412504e3f4336a22971679c5debac8a353d78..162b45887e21b9424d5f8b4bd3d7dad8e6d0d3e7 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -326,3 +326,9 @@ For workspace-specific issues:
 - See the [GitLab Workspaces documentation](https://docs.gitlab.com/user/workspace/).
 - Reach out in the Slack `#f_workspaces` channel.
 - Create an issue in the [Workspace User Feedback Epic](https://gitlab.com/groups/gitlab-org/-/epics/12601).
+
+## Debugging
+
+The project includes a `.vscode/launch.json` file that you can use in Visual Studio Code when debugging the code.
+Add the command line arguments in the `args` array otherwise you will see the default `--help` output.
+Make sure you don't commit this file when pushing your changes.