Runtime and Debug Workbench
Runtime and Debug Workbench
Section titled “Runtime and Debug Workbench”The header above your log panels is the runtime workbench. It is where running and debugging happen, and where you read whether a debugger is attached.
The title reads Runtime · <project>, with a live indicator and the count of open deployments and panels (open / max).
Start a Service
Section titled “Start a Service”The Start button has a menu of start options:
- Start normally — run the service.
- Attach debugger — attach to an already running process.
- Start with debugger — launch and debug in one step.
Which options are available depends on the service’s language runtime and policy (see below).
Debugger State
Section titled “Debugger State”Once a debugger is attached, the workbench shows it:
- Debugger attached — connected, running.
- Paused — stopped at a breakpoint; the header shows
paused @ source:line. - Continue resumes execution.
The agent drives breakpoints and inspection through MCP debug tools; the workbench is where you see the debugger’s state and step it by hand when you want to.
When Debugging Is Unavailable
Section titled “When Debugging Is Unavailable”If Start with debugger is disabled, the button’s tooltip tells you why. The common reasons:
- No deployment selected.
- The target is not a local managed-language-runtime deployment — code debugging needs one.
- The service has no language set, or no debuggable launch entry.
- Debugging is disabled by policy for this deployment.
- Debugging is only allowed in the
devenvironment by default.
The “what languages support this and what the contract is” lives in Language Runtime Provider. Auth for debug targets lives in Debug credentials.
Debug Browser
Section titled “Debug Browser”Open debug browser launches a Chromium browser the agent can drive for frontend debugging. It can wait on approval, and it tells you what is missing:
- Configure a debug browser first (in Settings).
- Choose a valid browser executable path.
- Start the frontend service / check readiness first.
- Pick a Chromium browser that supports remote debugging (CDP).
Arrange Panels
Section titled “Arrange Panels”The workbench controls the panel layout:
- Balanced — equal-size panels.
- Columns — column layout.
- Maximize / restore the whole workspace.
- Services and the log panel — open and split log panels.
- Project overview and ingress — runtime status, pipelines, config, ingress.