github · rentziass · Jun 10, 2026 · Apr 8, 2026 · Apr 8, 2026 · Apr 9, 2026
@@ -25,6 +25,8 @@
   "activationEvents": [
     "onView:workflows",
     "onView:settings",
+    "onDebugResolve:github-actions-job",
+    "onCommand:github-actions.debugger.connect",
     "workspaceContains:**/.github/workflows/**",
     "workspaceContains:**/action.yml",
     "workspaceContains:**/action.yaml"
@@ -97,7 +99,19 @@
         }
       }
     },
+    "debuggers": [
+      {
+        "type": "github-actions-job",
+        "label": "GitHub Actions Job Debugger",
+        "languages": []
+      }
+    ],
     "commands": [
+      {
+        "command": "github-actions.debugger.connect",
+        "category": "GitHub Actions",
+        "title": "Debug Running Job…"
+      },
       {
         "command": "github-actions.explorer.refresh",
         "category": "GitHub Actions",
@@ -521,6 +535,10 @@
         {
           "command": "github-actions.sign-in",
           "when": "false"
+        },
+        {
+          "command": "github-actions.debugger.connect",
+          "when": "config.github-actions.debugger.enabled && !isWeb"
         }
       ]
     }
@@ -544,6 +562,7 @@
     "@types/libsodium-wrappers": "^0.7.10",
     "@types/uuid": "^3.4.6",
     "@types/vscode": "^1.72.0",
+    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^5.40.0",
     "@typescript-eslint/parser": "^5.40.0",
     "@vscode/test-web": "^0.0.69",
@@ -579,7 +598,8 @@
     "tunnel": "0.0.6",
     "util": "^0.12.1",
     "uuid": "^3.3.3",
-    "vscode-languageclient": "^8.0.2"
+    "vscode-languageclient": "^8.0.2",
+    "ws": "^8.20.0"
   },
   "overrides": {
     "browserify-sign": {

@@ -4,13 +4,19 @@ import {resetGitHubContext} from "../git/repository";
 
 const settingsKey = "github-actions";
 const DEFAULT_GITHUB_API = "https://api.github.com";
+const reloadWindowAction = "Reload Window";
+const debuggerEnabledSettingsKey = getSettingsKey("debugger.enabled");
+
+let debuggerSettingReloadPromptVisible = false;
 
 export function initConfiguration(context: vscode.ExtensionContext) {
   context.subscriptions.push(
     vscode.workspace.onDidChangeConfiguration(async e => {
       if (e.affectsConfiguration(getSettingsKey("workflows.pinned"))) {
         pinnedWorkflowsChangeHandlers.forEach(h => h());
-      } else if (
+      }
+
+      if (
         e.affectsConfiguration(getSettingsKey("use-enterprise")) ||
         (useEnterprise() &&
           (e.affectsConfiguration("github-enterprise.uri") || e.affectsConfiguration(getSettingsKey("remote-name"))))
@@ -19,6 +25,10 @@ export function initConfiguration(context: vscode.ExtensionContext) {
         resetGitHubContext();
         await vscode.commands.executeCommand("github-actions.explorer.refresh");
       }
+
+      if (e.affectsConfiguration(debuggerEnabledSettingsKey)) {
+        await promptToReloadForDebuggerSettingChange(context);
+      }
     })
   );
 }
@@ -64,6 +74,10 @@ export function getRemoteName(): string {
   return getConfiguration().get<string>(getSettingsKey("remote-name"), "origin");
 }
 
+export function isDebuggerEnabled(): boolean {
+  return getConfiguration().get<boolean>(debuggerEnabledSettingsKey, false);
+}
+
 export function useEnterprise(): boolean {
   return getConfiguration().get<boolean>(getSettingsKey("use-enterprise"), false);
 }
@@ -87,3 +101,35 @@ async function updateLanguageServerApiUrl(context: vscode.ExtensionContext) {
 
   await initLanguageServer(context);
 }
+
+async function promptToReloadForDebuggerSettingChange(context: vscode.ExtensionContext) {
+  if (vscode.env.uiKind !== vscode.UIKind.Desktop) {
+    return;
+  }
+
+  if (debuggerSettingReloadPromptVisible) {
+    return;
+  }
+
+  debuggerSettingReloadPromptVisible = true;
+
+  try {
+    if (context.extensionMode !== vscode.ExtensionMode.Production) {
+      await vscode.window.showInformationMessage(
+        "Reload VS Code manually to apply the GitHub Actions debugger preview setting change. Automatic reload is disabled in the Extension Development Host."
+      );
+      return;
+    }
+
+    const selection = await vscode.window.showInformationMessage(
+      "Reload VS Code to apply the GitHub Actions debugger preview setting change.",
+      reloadWindowAction
+    );
+
+    if (selection === reloadWindowAction) {
+      await vscode.commands.executeCommand("workbench.action.reloadWindow");
+    }
+  } finally {
+    debuggerSettingReloadPromptVisible = false;
+  }
+}