# capture_since

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

> Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted. What a pane has printed since you last looked. Call it once with no cursor to start watching and get the current screen; keep the cursor it returns and pass it back each time after that, and you are charged only for what is new. This is the tool for watching a build, a log, or a test run — not a capture_pane loop. Set waitMs to block until something arrives rather than returning empty. Reports the stream in the order it was written, so a program that draws by moving the cursor (a progress bar, a full-screen TUI) reads jumbled here — capture_pane renders those.

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. What a pane has printed since you last looked. Call it once with no cursor to start watching and get the current screen; keep the cursor it returns and pass it back each time after that, and you are charged only for what is new. This is the tool for watching a build, a log, or a test run — not a [capture\_pane](https://libtmux.org/en/ts/latest/mcp/tools/capture_pane/) loop. Set waitMs to block until something arrives rather than returning empty. Reports the stream in the order it was written, so a program that draws by moving the cursor (a progress bar, a full-screen TUI) reads jumbled here — [capture\_pane](https://libtmux.org/en/ts/latest/mcp/tools/capture_pane/) renders those.

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

## Arguments

* `cursor` optional · string

  The cursor from your previous capture\_since. Omit on the first call.

* `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.

* `waitMs` optional · integer

  Wait up to this long for new output before answering. Default 0.

## Schemas

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