# diagnose_failing_pane

Source: https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/

> Gather pane context and propose a root-cause hypothesis.

promptMCPlatest

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

* **diagnose_failing_pane**( [pane_id](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane.parameter.pane_id), )

  prompt[¶](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane)

  Gather pane context and propose a root-cause hypothesis.

  Uses [`snapshot_pane`](https://libtmux.org/en/py/latest/mcp/tools/snapshot_pane/) (content + cursor + mode + scroll state in one call) instead of [`capture_pane`](https://libtmux.org/en/py/latest/mcp/tools/capture_pane/) + [`get_pane_info`](https://libtmux.org/en/py/latest/mcp/tools/get_pane_info/) so the agent sees everything in a single protocol call. When the diagnosis needs another read after waiting or observing, the rendered recipe points agents at [`capture_since`](https://libtmux.org/en/py/latest/mcp/tools/capture_since/) instead of a repeated full capture.

  * MCP request method

    `prompts/get` Send `diagnose_failing_pane` as the prompt name, with the arguments below.

  ## Arguments[#](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane.parameters)

  * `pane_id`[#](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane.parameter.pane_id)

    The pane to diagnose.

    Provide a value matching the following JSON schema: {“type”:“string”}. Encode non-string values as JSON.

    * Binding

      Prompt argument

    * Required

      Yes

  ## Result[#](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane.result)

  Returns the prompt’s messages. The client supplies the advertised arguments as strings.

  ## Protocol data[#](https://libtmux.org/en/py/latest/mcp/prompts/diagnose_failing_pane/#mcp.prompt.diagnose_failing_pane.schemas)

  Use the complete advertised contract for validation and client integration.

  Registration

  ```json
  {
    "_meta": {
      "fastmcp": {
        "tags": []
      }
    },
    "arguments": [
      {
        "description": "The pane to diagnose.\n\nProvide a value matching the following JSON schema: {\"type\":\"string\"}. Encode non-string values as JSON.",
        "name": "pane_id",
        "required": true
      }
    ],
    "description": "Gather pane context and propose a root-cause hypothesis.\n\nUses ``snapshot_pane`` (content + cursor + mode + scroll state\nin one call) instead of ``capture_pane`` + ``get_pane_info`` so\nthe agent sees everything in a single protocol call. When the\ndiagnosis needs another read after waiting or observing, the\nrendered recipe points agents at ``capture_since`` instead of a\nrepeated full capture.",
    "name": "diagnose_failing_pane"
  }
  ```

Source revision: [tmux-python/libtmux-mcp@4daddc0dfca96c43bf521d818bf91564e1434760](https://github.com/tmux-python/libtmux-mcp/tree/4daddc0dfca96c43bf521d818bf91564e1434760).