tmux-python/libtmux-mcp

MCP for tmux, powered by libtmux

Stars: 13
Forks: 0
Open beginner issues: 0
Indexed issues: 23
Avg merge: 13h 52m
Merged PRs (30d): 4

Dominant language: Python
License: MIT
Last GitHub push: Sep 19, 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

23 open issues indexed

run_command: tmux completion wrapper breaks over SSH panes (error connecting to socket) Open

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

tmux-python/libtmux-mcp#132 · 1 comment · Opened Sep 13, 2026
Clarify that MCP Safety controls tool visibility, not OS-level confinement. Open

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

tmux-python/libtmux-mcp#127 · 2 comments · Opened Aug 28, 2026
BOM and `--pr` input handling in mcp_swap Open

bug

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

tmux-python/libtmux-mcp#121 · Opened Aug 10, 2026
`--repo` without `[project.scripts]` exits with a traceback Open

bug

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

tmux-python/libtmux-mcp#120 · Opened Aug 10, 2026
A deleted backup wedges its swap-state entry permanently Open

bug

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

tmux-python/libtmux-mcp#119 · Opened Aug 10, 2026
Unknown swap-state key blocks every revert and swap Open

bug

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

tmux-python/libtmux-mcp#118 · Opened Aug 10, 2026
`revert` can leave a config swapped and delete every backup Open

bug

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

tmux-python/libtmux-mcp#117 · Opened Aug 10, 2026
pytest filterwarnings suppresses the DeprecationWarnings this project needs to see Open

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

tmux-python/libtmux-mcp#111 · Opened Jul 25, 2026
Migrate wait_for_text off the deprecated MCP Logging capability (SEP-2577) Open

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

tmux-python/libtmux-mcp#109 · Opened Jul 25, 2026
test_respawn_pane_replaces_shell races the respawned exec under CI parallelism Open

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

tmux-python/libtmux-mcp#107 · Opened Jul 25, 2026
wait_for_text: entry cursor row's content stays suppressed for the whole wait Open

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

tmux-python/libtmux-mcp#106 · Opened Jul 25, 2026
Nudge agents toward batching: a post-single-call system-reminder Open

enhancement

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

tmux-python/libtmux-mcp#102 · Opened Jul 22, 2026
`tmux_batch`: one discoverable front door for multi-action batches Open

enhancement

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

tmux-python/libtmux-mcp#101 · Opened Jul 22, 2026
Surface invocation context (in tmux? server running? which socket?) and make tmux-server auto-start explicit Open

enhancement

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

tmux-python/libtmux-mcp#96 · Opened Jul 11, 2026
The list_* family is unbounded, unscoped, unprojected — and explicitly excluded from the response limiter Open

enhancement

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

tmux-python/libtmux-mcp#95 · Opened Jul 11, 2026
The caller's tmux socket is advertised in the instructions but never targeted: an MCP inside `tmux -L work` queries `default` Open

bug

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

tmux-python/libtmux-mcp#94 · Opened Jul 11, 2026
Add a self-location primitive (where_am_i): agents must dump every pane on the server to learn which pane they are in Open

enhancement

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

tmux-python/libtmux-mcp#93 · Opened Jul 11, 2026
The documented self-location recipe is unexecutable: filters={"is_caller": true} silently returns [] Open

bug

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

tmux-python/libtmux-mcp#92 · Opened Jul 11, 2026
Error middleware masks the real tool error when the logging path itself fails Open

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

tmux-python/libtmux-mcp#66 · Opened Jun 7, 2026
wait_for_text: adaptive backoff to reduce subprocess pressure on parallel waits Open

enhancement

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

tmux-python/libtmux-mcp#52 · 1 comment · Opened May 15, 2026
wait_for_text: optional include_baseline_row=True for in-place row writes Open

enhancement

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

tmux-python/libtmux-mcp#51 · 1 comment · Opened May 15, 2026
wait_for_text: two-call state/capture race within a single poll tick Open

enhancement

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

tmux-python/libtmux-mcp#50 · 1 comment · Opened May 15, 2026
MCP tool calls fail: invalid JSON when passing session_name / session_id (Cursor agent) Open

bug

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

tmux-python/libtmux-mcp#17 · 3 comments · Opened Apr 19, 2026

A short digest of beginner-friendly GitHub issues.