# clear_pane_scrollback

Source: https://libtmux.org/en/rs/latest/mcp/tools/clear_pane_scrollback/

> Discard a pane's scrollback, so the next capture_pane returns only what happens next. Use this before running something whose output you want to read cleanly: it is far cheaper than reading past the old output every time. The visible screen is left alone. Delete tmux state; accepts no command payload.

MCP is in development

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

Discard a pane’s scrollback, so the next [capture_pane](https://libtmux.org/en/rs/latest/mcp/tools/capture_pane/) returns only what happens next. Use this before running something whose output you want to read cleanly: it is far cheaper than reading past the old output every time. The visible screen is left alone. Delete tmux state; accepts no command payload.

[All Rust tools](https://libtmux.org/en/rs/latest/mcp/tools/) · [JSON](https://libtmux.org/en/rs/latest/mcp/tools/clear_pane_scrollback.json) · [Source](https://github.com/libtmux/libtmux-rs/blob/2cef1aa642182dd1970c3688feb6a568ff666e64/crates/tmux-mcp/src/tools/control.rs#L584)

## Arguments

* `pane` required · string

  The \`%\`-prefixed pane id, as \`list_panes\` reports it.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "pane": {
      "description": "The `%`-prefixed pane id, as `list_panes` reports it.",
      "type": "string"
    }
  },
  "required": [
    "pane"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pane": {
      "description": "The pane that changed.",
      "type": "string"
    }
  },
  "required": [
    "pane"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": false,
  "readOnlyHint": false,
  "title": "Clear Pane History"
}
```
