# libtmux

> Typed tmux control libraries for Python, Ruby, Lua, TypeScript, Rust, Go, Java, Kotlin, Scala, C#, F#, C++, Swift. This site includes shared concepts and language-specific guides, examples and API references.

## Concepts

- [Server, session, window, pane](https://libtmux.org/ja/tmux/concepts/server-session-window-pane/): How tmux servers, sessions, windows, panes and attached clients relate to each other.
- [Control mode vs one-shot](https://libtmux.org/ja/tmux/concepts/transports/): Choose subprocesses, command batches, or persistent connections to send commands and receive events.
- [Filtering and queries](https://libtmux.org/ja/tmux/concepts/queries/): How you get from every session on the server to the one pane you mean, and what happens when zero or several match.
- [Workspaces](https://libtmux.org/ja/tmux/concepts/workspaces/): Build pane layouts with the object API or a workspace configuration file.

## Examples

- [Examples](https://libtmux.org/ja/tmux/examples/): Programs for sending input, capturing output, and building workspaces.
- [Attach and send keys](https://libtmux.org/ja/tmux/examples/attach-and-send-keys/): Get a session handle, send a command to a pane, and capture output.
- [Capture pane output](https://libtmux.org/ja/tmux/examples/capture-pane-output/): Capture a tmux pane's screen and wait for a complete output line.
- [Build a workspace from a file](https://libtmux.org/ja/tmux/examples/workspace-from-file/): Create tmux windows and panes from a command file on a private server.

## Guides

- [Guides](https://libtmux.org/ja/tmux/guides/): Task-oriented walkthroughs that sit between the concepts and each port's own API reference.
- [Getting started](https://libtmux.org/ja/tmux/guides/getting-started/): Create a tmux session, add a window and split it into panes.
- [Attaching to tmux](https://libtmux.org/ja/tmux/guides/attaching-to-tmux/): Create or attach to a tmux session, select its socket, and keep terminal attachment separate from automation.
- [Sending keys](https://libtmux.org/ja/tmux/guides/sending-keys/): Send literal text or named keys to a tmux pane and distinguish input from completion.
- [Capturing output](https://libtmux.org/ja/tmux/guides/capturing-output/): Capture a tmux pane screen or include its scrollback history.
- [Querying and filtering](https://libtmux.org/ja/tmux/guides/querying-and-filtering/): Find an exact tmux session and select one pane using formats and filters.
- [Testing with tmux](https://libtmux.org/ja/tmux/guides/testing-with-libtmux/): Test on a private tmux server and preserve errors during cleanup.

## Overview

- [Third-party notices](https://libtmux.org/ja/third-party-notices/): Thanks to tmux's creator and contributors, with licences and attribution for the software behind libtmux.org.

## Topics

- [Topics](https://libtmux.org/ja/tmux/topics/): Object traversal, cleanup, pane I/O, configuration, and failure handling.
- [Architecture](https://libtmux.org/ja/tmux/topics/architecture/): Locate operations, distinguish snapshots from live commands, and find their implementation.
- [Traversal](https://libtmux.org/ja/tmux/topics/traversal/): Moving up and down the server/session/window/pane tree, and the two questions that come up once you have more than one object.
- [Ownership and cleanup](https://libtmux.org/ja/tmux/topics/context-managers/): Scope-based cleanup for tmux objects, and when your program must kill them explicitly.
- [Pane interaction](https://libtmux.org/ja/tmux/topics/pane-interaction/): Input defaults, screen capture, and waiting for a command to finish.
- [Options and hooks](https://libtmux.org/ja/tmux/topics/options-and-hooks/): Read and update tmux options, and register commands for tmux events.
- [Format-token fields](https://libtmux.org/ja/tmux/topics/format-tokens/): The typed fields every object exposes, mirroring tmux's own format tokens, and why a field is sometimes absent.
- [Waiting and retrying](https://libtmux.org/ja/tmux/topics/waiting-and-retry/): Polling a condition instead of guessing a sleep, and tmux's own wait-for signal channel as the alternative to polling.
- [Environment](https://libtmux.org/ja/tmux/topics/environment/): Locate tmux objects from process variables and manage the environment inherited by new panes.
- [Socket and servers](https://libtmux.org/ja/tmux/topics/socket-and-servers/): Select a server socket, check liveness, and detect a replacement daemon.
- [Errors and exceptions](https://libtmux.org/ja/tmux/topics/errors-and-exceptions/): Handle command failures, inspect delivery status, and decide when a retry is safe.

## コンセプト

- [コンセプト](https://libtmux.org/ja/tmux/concepts/): tmux のサーバー、セッション、ウィンドウ、ペインの仕組み。

## Optional

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