Skip to main content
Accepts a recording ID or a natural-language description, fetches session data via the workspace MCP server, and produces a correlated timeline with a root cause analysis.

​
Usage

/userplane:debug <recording-id>

/userplane:debug <description>

​
How it resolves recordings

By recording ID — resolves the workspace automatically and fetches the recording directly. 
/userplane:debug rec_01HX2KYN
By description — searches recordings by user, project, or time range, narrows to 1–3 candidates, and confirms with you before fetching session data. 
/userplane:debug "Sarah's checkout failure yesterday"

​
What it produces

  1. Summary — one sentence describing the issue.
  2. Timeline — interleaved user actions, console errors, and network failures ordered by timestamp.
  3. Root cause — the specific failure point with quoted evidence from console or network data.
  4. Fix — a concrete code change when the repo is accessible, or a description of what to investigate.
Requires workspace MCP authentication. If you haven’t authenticated yet, Claude Code opens a browser for OAuth sign-in on the first call.

​
Example prompts

Here's a recording from a customer who can't complete checkout — https://dash.userplane.io/{workspaceId}/recordings/{recordingId}. What's causing the issue?

A customer reported a blank screen after login. Pull up the latest recording in the Auth project and check the console for errors.

/userplane:debug "the payment form crash from this morning"

Debug this recording. Focus on network requests — the customer said the page loaded but nothing saved. https://dash.userplane.io/{workspaceId}/recordings/{recordingId}

Walk me through what the user did in this recording. What pages did they visit, what did they click, and where did things break? https://dash.userplane.io/{workspaceId}/recordings/{recordingId}
Replace {workspaceId} and {recordingId} with values from your Userplane dashboard URL bar.
  • debug-agent — the subagent that powers this command.
  • MCP Servers — the workspace MCP server this command uses.
  • Recording Tools — the underlying MCP tools for recording data.
  • MCP Apps — interactive viewers for recordings, console, network, and actions.