# libtmux:clear-history

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/terminal-operations.lisp#L44
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-clear-history/

```
(clear-history client pane &key cancel-token timeout output-limit)
```

Clear PANE's retained tmux history; return a COMMAND-OUTCOME.
Captured observations remain unchanged. This does not promise to clear the
application's current screen. Signals STALE-TARGET or an operational condition.

## Parameters

- `client`
- `pane`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `clear-history`.

- [`clear-history`](/en/tmux/latest/manual/clear-history/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_clear_history_entry`](/en/tmux/latest/reference/c-variable-cmd_clear_history_entry/) (attribute)
- [`cmd_capture_pane_exec`](/en/tmux/latest/reference/c-function-cmd-capture-pane-c-cmd_capture_pane_exec/) (function)

## Guides

Pages that discuss `clear-history`.

- [Explicit operations](/en/lisp/latest/guides/operations/)