# libtmux:list-commands

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/key-bindings.lisp#L19
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-list-commands/

```
(list-commands client &key command format cancel-token timeout output-limit)
```

Inspect built-in tmux commands; return owned UTF-8 printer text and an outcome.
Omit COMMAND to list all built-ins. COMMAND is an exact name or built-in alias
through tmux 3.5a; unknown selectors produce no rows. From 3.6, unique prefixes
are accepted and unknown/ambiguous selectors fail. Configured command-alias
entries are not listed or expanded by this selector.

FORMAT is explicit tmux format source, without time expansion. #() can start
asynchronous jobs owned by this command client; results may be incomplete and
disconnect cleans up those jobs. Omission uses tmux's human-readable format.
Preserve native escaping, whitespace and after-hook output; this is not a
decoded registry.
Blocks under shared preflight/dispatch limits, never retries and starts no
daemon. Failures retain their outcome; invalid UTF-8 signals DECODING-ERROR.

See also: `libtmux:display-message`, `libtmux:error-outcome`, `libtmux:list-keys`, `libtmux:outcome-stdout`.

## Parameters

- `client`
- `command?`
- `format?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## Guides

Pages that discuss `list-commands`.

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