Jesse-njx/dsh-tmuxctl
dsh-tmuxctl — the control plane for tmux: list, drive, capture, split, swap, run
dsh-tmuxctl is the active control plane for tmux — it turns the tmux grid you already have open (servers, log tails, REPLs, build watchers) into an addressable surface the agent can list, type into, capture, rearrange and watch, with safety by default. DSH core ships dsh-tmux-context, a passive plugin that names the pane the harness lives in; tmuxctl is its active counterpart. Tools: tmux_list (sessions, windows with layout, panes with target/%paneId/size/current command/active/created-by-us), tmux_send_keys (types literal text via send-keys -l --, optional Enter), tmux_capture (visible text, optionally -S scrollback lines), tmux_split (split beside a target, marking the new pane created-by-us), plus rearrange/watch tools — all destructive operations pass an approval gate. Because tmux owns every process, a watched build tail, server log or REPL session stays inspectable and steerable without extra daemons.
Install
dsh plugin add github:Jesse-njx/dsh-tmuxctlGitHub install per README (EN primary); npm @dsh-tmuxctl/bundle not yet published (404 verified 2026-09-03 — README says 'or, once published to npm: dsh plugin add @dsh-tmuxctl/bundle', not claimed). One command installs both halves: dsh plugin add github:Jesse-njx/dsh-tmuxctl — the host half registers eight tmux_* tools plus the destructive-op approval gate and tmux/capture snapshot events; the client half adds the tmux-capture conversation node rendering each snapshot as a collapsed-by-default expandable card. tmux must be installed and on PATH (brew install tmux / apt install tmux).
Compatibility
DeepSeek Harness plugin bundle; requires tmux on PATH; installs into the profile you chat/agent from (web or headless).
Details
- Repo: Jesse-njx/dsh-tmuxctl
- Category: Agent Capabilities
- Stars: 0
- Version: git github:Jesse-njx/dsh-tmuxctl
- Last push: 2026-08-13
- First seen: 2026-08-13
Recent updates
Eight tmux_* tools; destructive-op approval gate; tmux-capture snapshot event + collapsed expandable chat card; created-by-us pane tracking; no extra daemons.
FAQ
- What does it add over the built-in dsh-tmux-context?
- dsh-tmux-context is passive (it names the pane the harness lives in); dsh-tmuxctl is the active half — it lists, drives, captures, rearranges and watches your existing tmux grid.
- How are destructive operations protected?
- Destructive ops go through an approval gate; panes created by the plugin are tracked so the agent can distinguish its own targets.
- How do I install it?
- dsh plugin add github:Jesse-njx/dsh-tmuxctl installs both the host and client halves in one command; tmux itself must be on PATH.
Alternatives
nexusagentx/dsh-lens · moduqishi/dsh-open-in-finder · wloops/dsh-git-worktree