GeezerVison

Summary

• Bump libtmux from ~=0.55.0 to ~=0.56.0
• Whitelist libtmux from the exclude-newer cooldown so contributor uv sync works against the new pin without waiting 3 days
• Picks up libtmux 0.55.1 (test-fixture socket-cleanup fix) and 0.56.0 (50+ new tmux command wrappers, move_window() auto-refresh fix, control_mode pytest fixture, TMUX_MAX_VERSION -> 3.7)
• No tmuxp code or test changes needed — v0.56.0 is purely additive on the surface tmuxp imports, and tmuxp's only Window.move_window() call doesn't read post-move attributes so the upstream auto-refresh fix is a free correctness improvement

Upstream changes

libtmux 0.56.0 (2026-05-10)

What's new (#653)

• Interactive tmux commands now scriptable: new wrappers for the commands that previously required hand-rolled Server.cmd() calls — Pane.display_popup, Server.display_menu, Server.command_prompt, Server.confirm_before, Session.detach_client, Server.detach_client, Server.detach_all_clients, Pane.display_panes, plus the choose_* family (choose_buffer, choose_client, choose_tree). The three detach-client wrappers each map to one tmux flag group with a single subprocess call.
• tmux buffer I/O suite: Server.set_buffer, show_buffer, delete_buffer, save_buffer, load_buffer, list_buffers, plus Pane.paste_buffer round-trip pane content through named tmux buffers.
• Key bindings and shell execution: Server gains bind_key, unbind_key, list_keys, list_commands, run_shell, if_shell, source_file, list_clients, start_server, lock_server, lock_client, refresh_client, suspend_client, server_access, show_messages, show_prompt_history, clear_prompt_history. Session gains lock_session. Pane gains send_prefix.
• Window/pane manipulation parity: new Window.swap, link, unlink, respawn, last_pane, next_layout, previous_layout, rotate; new Pane.swap, join, break_pane, move, pipe, clear_history, respawn, copy_mode, clock_mode, customize_mode, find_window; new Server.wait_for, Session.last_window, next_window, previous_window.
• Filled-in flag coverage on existing methods: Pane.send_keys (literal, hex, key-name, format, client), Pane.split (percentage=), Pane.capture_pane (alternate-screen, quiet, write-to-buffer), Pane.display_message, Pane.display_popup (target_client=, -c), Window.move_window (after, before, kill, renumber), Window.select_layout (spread, next, previous), Server.new_session, Session.new_window, Server.set_environment, Server.show_options (quiet=).
• control_mode pytest fixture: spawns a real tmux -C client attached to the session so commands that require an attached client are testable without a TTY.

Bug fixes (#653)

• Window.move_window() now refreshes the moved window automatically; previously the Window object pointed at its pre-move index until a manual refresh(). tmuxp's only call site (workspace/builder.py:629) doesn't read post-move attributes, so this is a free correctness improvement.

Development (#653)

• TMUX_MAX_VERSION bumped to "3.7", unlocking method coverage already version-gated for tmux 3.7 (notably command_prompt(bspace_exit=) and show_messages(terminals=, jobs=)). No effect on installations running tmux 3.6 or earlier.

libtmux 0.55.1 (2026-04-19)

• pytest_plugin: server and TestServer fixture finalizers now unlink(2) the tmux socket from /tmp/tmux-<uid>/ in addition to server.kill(). tmux doesn't reliably unlink its socket on non-graceful exit, so long-lived dev machines were accumulating 10k+ stale libtmux_test* entries (Remove Python 2.7 #661, fixes Freeze config for attached session #660).

Changes in this PR

• Whitelist commit (1d6bb889): adds libtmux = false to [tool.uv.exclude-newer-package] in pyproject.toml so the rolling 3-day cooldown doesn't block contributor uv sync against the new pin. Mirrors the precedent set in 6c0a0b2d for the gp-* dep surface.
• Package bump (3754a060): pyproject.toml libtmux~=0.55.0 -> libtmux~=0.56.0; uv.lock regenerated via uv lock --upgrade-package libtmux (other packages unchanged).
• No code changes: tmuxp imports only stable APIs unaffected by v0.56.0.
• No test changes: existing test surface continues to work against the new wheel.

Test plan

• uv run py.test passes locally
• uv run mypy passes
• uv run ruff check . passes
• CI green on all matrix legs (CI doesn't carry the user-level cooldown so it won't need the whitelist to resolve)

Release: https://github.com/tmux-python/libtmux/releases/tag/v0.56.0
Changelog: https://libtmux.git-pull.com/history.html