# libtmux for Kotlin

> The Kotlin library (io.github.libtmux:libtmux-kotlin). These pages include its guides, tested examples and API documentation.

## Concepts

- [Concepts](https://libtmux.org/en/kotlin/latest/concepts/): Understand Kotlin handles, filters, transports and layout ownership.
- [Server, session, window, pane](https://libtmux.org/en/kotlin/latest/concepts/server-session-window-pane/): Traverse captured Kotlin handles, retain IDs and refresh after changes.
- [Filtering and queries](https://libtmux.org/en/kotlin/latest/concepts/queries/): Compose Kotlin filters, distinguish zero and several matches, and query captured relations.
- [Commands and control mode](https://libtmux.org/en/kotlin/latest/concepts/transports/): Use Kotlin command calls and persistent control connections with explicit cleanup.
- [Layouts and repeated setup](https://libtmux.org/en/kotlin/latest/concepts/workspaces/): Create and reuse Kotlin tmux layouts while preserving running processes.

## Examples

- [Examples](https://libtmux.org/en/kotlin/latest/examples/): Tested Kotlin examples against an isolated tmux server.
- [Capture pane output](https://libtmux.org/en/kotlin/latest/examples/capture-pane-output/): Run a complete Kotlin program that captures output on an isolated tmux server.

## Guides

- [Guides](https://libtmux.org/en/kotlin/latest/guides/): Guides for io.github.libtmux:libtmux-kotlin.
- [Getting started](https://libtmux.org/en/kotlin/latest/guides/getting-started/): Getting started: io.github.libtmux:libtmux-kotlin documentation.
- [Attaching to tmux](https://libtmux.org/en/kotlin/latest/guides/attaching-to-tmux/): Connect to an existing tmux server and find a session with Kotlin.
- [Coroutines and flows](https://libtmux.org/en/kotlin/latest/guides/coroutines/): Coroutines and flows: io.github.libtmux:libtmux-kotlin documentation.

## Reference

- [Kotlin API reference](https://libtmux.org/en/kotlin/latest/reference/): every public symbol, generated from the source. Hosted on libtmux.org.

## Optional

- [Full documentation text](https://libtmux.org/en/kotlin/latest/llms-full.txt): guides and MCP contracts in a single fetch.