# libtmux_mcp.tools.hook_tools.show_hook

- **Module:** libtmux_mcp.tools.hook_tools
- **Package:** libtmux-mcp
- **Language:** Python
- **Kind:** function
- **Source:** https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/tools/hook_tools.py#L198
- **Page:** https://libtmux.org/en/py/latest/mcp/reference/libtmux_mcp-tools-hook_tools-show_hook/

```
libtmux_mcp.tools.hook_tools.show_hook(hook_name: str, scope: t.Literal["server", "session", "window", "pane"] | None = None, target: str | None = None, global_: bool = False, socket_name: str | None = None) -> HookListResult
```

Look up a specific tmux hook by name.

Returns a :class:`~libtmux_mcp.models.HookListResult` with zero or
more :class:`~libtmux_mcp.models.HookEntry` rows — zero if the hook
is unset, one if it is a scalar hook, and multiple if it is an
array hook with sparse indices.

## Parameters

- `hook_name` (str): Hook to look up (e.g. ``"pane-exited"``).
- `scope` (t.Literal["server", "session", "window", "pane"] | None)
- `target` (str | None)
- `global_` (bool)
- `socket_name` (str | None)

## Returns

HookListResult
    One or more :class:`~libtmux_mcp.models.HookEntry` rows, or empty if unset.