# capture_pane

Source: https://libtmux.org/en/ts/latest/mcp/tools/capture_pane/

> Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. The text a pane is showing, or its scrollback. Negative `start` reaches back into history (-100 is a hundred lines above the top of the screen). For repeated reads of the same pane use capture_since instead — it returns only what is new.

MCP is in development

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

Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. The text a pane is showing, or its scrollback. Negative `start` reaches back into history (-100 is a hundred lines above the top of the screen). For repeated reads of the same pane use [capture\_since](https://libtmux.org/en/ts/latest/mcp/tools/capture_since/) instead — it returns only what is new.

[All TypeScript tools](../) · [JSON](../capture_pane.json) · [Source](https://github.com/libtmux/libtmux-ts/blob/3fe1ca654b81b8cbf4a13b777a001a3298c87a6f/packages/mcp/src/tools/capture.ts#L27)

## Arguments

* `end` optional · integer

  Last line, on the same scale as start: 0 is the top of the visible screen and negative reaches back into history. It does not count back from the bottom, so end:-1 is one line above the screen top, not the last line of output.

* `joinWrapped` optional · boolean

  Rejoin lines tmux wrapped.

* `maxLines` optional · integer

  Keep at most this many lines, from the end. Defaults to the server limit.

* `paneId` required · string

  Stable pane id, e.g. %1.

* `start` optional · integer

  First line; negative reaches into scrollback.

## Schemas

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