tmux-python/libtmux

View on GitHub

⚙️ Python API / wrapper for tmux

Stars: 1.2k
Forks: 127
Open beginner issues: 0
Indexed issues: 104
Avg merge: 2h 13m
Merged PRs (30d): 1

Dominant language: Python
License: MIT
Last GitHub push: Sep 12, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

104 open issues indexed

`show_option` coerces user options, so an `@` option set to `123` or `on` comes back as an int or a bool Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

tmux-python/libtmux#759 · Opened Sep 18, 2026
Add quotes around format strings for compatibility with msys2 (git bash) Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

tmux-python/libtmux#745 · 2 comments · Opened Aug 21, 2026
Documentation: how to use internal libtmux logging Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

tmux-python/libtmux#744 · Opened Aug 20, 2026
feature: upstream capture_since Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 65/100

tmux-python/libtmux#740 · 1 comment · Opened Aug 14, 2026
Subclassing `ObjectDoesNotExist` and forwarding `**kwargs` fails mypy Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

tmux-python/libtmux#737 · Opened Aug 12, 2026
`Server.wait_for()` has no timeout, so a pane that never signals hangs forever Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tmux-python/libtmux#732 · Opened Jul 31, 2026
`test_control_mode_stdout_preserves_non_ascii_output` polls `select` on a buffered stream Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

tmux-python/libtmux#731 · Opened Jul 31, 2026
`retry_until`'s zero-arg predicate forces a loop-variable closure that ruff `B023` and mypy disagree about Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

tmux-python/libtmux#726 · Opened Jul 29, 2026
`Server` does not validate socket path length; overrun surfaces as a raw tmux `File name too long` Open

Difficulty 4/5 3-5 days Newbie friendliness 68/100

tmux-python/libtmux#725 · Opened Jul 29, 2026
`Server.__exit__` kills any live server, including one it did not start Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tmux-python/libtmux#724 · Opened Jul 29, 2026
`Server.__repr__` hard-codes `/tmp/tmux-<euid>/default`, ignoring `$TMUX_TMPDIR` Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

tmux-python/libtmux#723 · Opened Jul 29, 2026
docs(pane_interaction, workspace_setup): the same shell-echo race #706 fixed in automation_patterns Open

Difficulty 4/5 3-5 days Newbie friendliness 52/100

tmux-python/libtmux#715 · Opened Jul 11, 2026
Expose tmux spawn provenance: a typed libtmux.env (TmuxEnv, spawn_session, is_inside_tmux) Open

Difficulty 5/5 Over a week Newbie friendliness 45/100

tmux-python/libtmux#712 · 1 comment · Opened Jul 11, 2026
docs(automation_patterns): the wait helpers never wait — the marker matches the command echo Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 72/100

tmux-python/libtmux#706 · Opened Jul 11, 2026
No self-location API (TMUX_PANE), and the socket_path derivation in Server.__init__ is unreachable dead code Open

bug enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#704 · 1 comment · Opened Jul 11, 2026
Research tmux-continuum parity for headless autosave Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#702 · Opened Jul 4, 2026
Research tmux-resurrect parity for workspace archives Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#701 · Opened Jul 4, 2026
Operationalize typed operations and engines (follow-up to #688) Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#689 · Opened Jun 21, 2026
Design typed operations and engines Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#688 · Opened Jun 21, 2026
Typed command descriptors for native tmux command chains Open

enhancement MCP

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#683 · Opened Jun 14, 2026
Investigate ty type checker alongside mypy Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

tmux-python/libtmux#681 · 1 comment · Opened May 24, 2026
Predictable error contract for display_message wrappers Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

tmux-python/libtmux#676 · Opened May 17, 2026
Per-client active-pane resolution for Client.attached_pane Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

tmux-python/libtmux#675 · Opened May 17, 2026
feat: Add Non-polling Waiters (Deterministic Channels & Delta-Polling) Open

Difficulty 5/5 Over a week Newbie friendliness 38/100

tmux-python/libtmux#673 · Opened May 16, 2026
Investigate libtmux-side trim detection for scrollback consumers Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#671 · Opened May 16, 2026
Wrapper gaps surfaced by libtmux-mcp adoption of 0.56.0 (14 sites) Open

enhancement MCP

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#670 · Opened May 13, 2026
Flaky test: test_capture_pane_flags[join_wrapped_numbers] matches marker in command echo Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

tmux-python/libtmux#654 · Opened Apr 1, 2026
perf: Push QueryList filters to tmux via -f format filter Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tmux-python/libtmux#646 · Opened Mar 21, 2026
feat: Add search_pane_contents() using tmux's native content search Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 50/100

tmux-python/libtmux#645 · Opened Mar 21, 2026
docs(docstrings): Add Examples/Returns sections to property aliases Open

Difficulty 3/5 1-2 days Newbie friendliness 62/100

tmux-python/libtmux#640 · Opened Mar 7, 2026
tmux config formatter Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

tmux-python/libtmux#639 · Opened Mar 7, 2026
config linter Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tmux-python/libtmux#638 · Opened Mar 7, 2026
[Agentic DX] libtmux: consolidated roadmap (core + async + engines) Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#629 · Opened Feb 17, 2026
libtmux mcp Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

tmux-python/libtmux#621 · Opened Jan 4, 2026
libtmux cli: `list-sessions`, `list-windows`, `list-panes` via colored cli output, json / ndjson Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#620 · Opened Jan 4, 2026
Need avoiding relying on sys.stdout Open

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

tmux-python/libtmux#600 · Opened Aug 27, 2025
new_session raises TmuxObjectDoesNotExist even though the session name is new Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tmux-python/libtmux#599 · 3 comments · 1 reaction · Opened Jun 17, 2025
Perfect mocking mechanism Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#591 · Opened Mar 2, 2025
Frozen dataclasses: sealable Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

tmux-python/libtmux#589 · Opened Feb 28, 2025
Frozen dataclasses Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

tmux-python/libtmux#588 · Opened Feb 28, 2025
Waiter v3.0: Requirements Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

tmux-python/libtmux#584 · Opened Feb 27, 2025
QueryList exception do not inherit from libtmux.exc.LibTmuxException Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tmux-python/libtmux#541 · Opened Jul 1, 2024
Environment: Add to `new-window`, `split-window`, `respawn-window`, `respawn-pane` Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tmux-python/libtmux#521 · Opened Feb 8, 2024
Options: Typed structures Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tmux-python/libtmux#518 · Opened Feb 8, 2024
Tests: Snapshots Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

tmux-python/libtmux#511 · Opened Jan 6, 2024
`TmuxObjectDoesNotExist` when creating `libtmux.Server().new_session(attach=True)` Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tmux-python/libtmux#502 · 13 comments · Opened Oct 21, 2023
unknown pytest option --doctest-docutils-modules Open

Difficulty 1/5 Under an hour Newbie friendliness 45/100

tmux-python/libtmux#496 · 7 comments · Opened Aug 20, 2023
`build(build-system)`: Remove `setuptools` build dependency Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

tmux-python/libtmux#494 · Opened Aug 20, 2023
select_pane not working correctly with multiple sessions Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tmux-python/libtmux#487 · 2 comments · Opened Jun 28, 2023
Intermittent / flaky test test_capture_pane Open

Difficulty 3/5 1-2 days Newbie friendliness 30/100

tmux-python/libtmux#484 · Opened May 17, 2023

tmux-python/libtmux

Get new issues in your inbox