# libtmux:run-command

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/client.lisp#L279
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-run-command/

```
(run-command client arguments &key effect input cancel-token (timeout (slot-value client (quote timeout))) (output-limit (slot-value client (quote output-limit))))
```

Execute explicit tmux argv and return a retained COMMAND-OUTCOME.
EFFECT must be :READ or :MUTATION. Arguments are literal argv strings; tmux's
own command/format grammar still applies. INPUT is an octet vector or NIL.
This escape hatch does not validate captured target identities. Failures signal
conditions retaining the outcome; uncertain mutations are never retried.

## Parameters

- `client`
- `arguments`
- `effect?`
- `input?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## Guides

Pages that discuss `run-command`.

### Concepts

- [Transport and cleanup](/en/lisp/latest/concepts/transport/)

### Examples

- [Capture pane output](/en/lisp/latest/examples/capture-pane-output/)

### Guides

- [Attaching to tmux](/en/lisp/latest/guides/attaching-to-tmux/)
- [Explicit operations](/en/lisp/latest/guides/operations/)