# libtmux:show-hooks-text

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/configuration-operations.lisp#L294
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-show-hooks-text/

```
(show-hooks-text client &key scope target name format monitors cancel-token timeout output-limit)
```

Inspect native hooks; return owned UTF-8 printer text and a COMMAND-OUTCOME.
SCOPE/TARGET follow SET-HOOK; :SERVER is unavailable because [show-hooks](/en/tmux/latest/manual/show-hooks/) has no
server-table flag. NAME is a literal native reference; omission lists hooks.
Tmux can infer a built-in's table from NAME. A named ordinary @ option can
also be printed; that success does not prove event registration.

FORMAT is explicit tmux format source with no implicit time expansion.
MONITORS selects native monitor presentation (-B). Both require live tmux 3.8.
#() in FORMAT can start command-client jobs with incomplete results and cleanup
on disconnect. Native escaping, whitespace and ordinary hook output remain
printer text, not a decoded or replayable configuration. No -R is invoked.
Blocks under shared preflight/dispatch limits, starts no daemon and never
retries. Missing names and decoding/resource failures retain outcome evidence.

See also: `libtmux:error-outcome`, `libtmux:set-hook`, `libtmux:show-options-text`, `libtmux:unset-hook`.

## Parameters

- `client`
- `scope?`
- `target?`
- `name?`
- `format?`
- `monitors?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## Guides

Pages that discuss `show-hooks-text`.

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