# tabby-control-tmux

> ControlTmux: right-click tmux controls for SSH tabs: new, attach, detach, close, and one-click tmux install

Latest version **0.1.1** (published 2026-09-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install tabby-control-tmux
pnpm add tabby-control-tmux
yarn add tabby-control-tmux
bun add tabby-control-tmux
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2026-09-23 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Nir Israel Hen |
| Maintainers | nirh87 |
| Keywords | tabby-plugin |

## Links

- npm: https://www.npmjs.com/package/tabby-control-tmux
- Repository: https://github.com/controlfix87/tabby-control-tmux
- Homepage: https://controlfix.net/#projects
- Issues: https://github.com/controlfix87/tabby-control-tmux/issues
- npm.io page: https://npm.io/package/tabby-control-tmux

## Recent versions

- 0.1.1 (latest) — 2026-09-23
- 0.1.0 — 2026-09-23

## README

# ControlTmux for Tabby

Control tmux on remote hosts from a right-click menu in Tabby SSH tabs.

Right-click an SSH tab (title or terminal body) to get a **ControlTmux** section:

- **New session** – default name, or *Named…* (types `tmux new-session -s ` for you to complete)
- **Attach to…** – pick from the sessions running on the host
- **Kill session** – pick a session to kill
- **Detach** – detach the current client
- **Close session** – kill the session you are in

Each item has a single-key shortcut shown on the right of the menu.

If tmux isn't installed on the host, the menu offers **Install tmux…**, which detects the package
manager (apt, dnf, yum, apk, pacman, zypper, brew) and runs the install in the tab, using `sudo`
when you aren't root (you type the password in the terminal).

Sessions are listed over a separate exec channel on the same SSH connection, so your terminal is never disturbed.
It works alongside [tabby-tmux](https://github.com/ruanimal/tabby-tmux) (control mode); the two serve different purposes.

## Preview

```
 ControlTmux
 ├─ New session        N  ▸  Default name  D
 │                          Named…         N
 ├─ Attach to…         A  ▸  1  main (attached)
 │                          2  work
 ├─ Kill session       K  ▸  1  main …
 ├─ ───────────
 ├─ Detach             D
 └─ Close session      C
```

## Install

Settings → Plugins → search for `tabby-control-tmux`, then restart Tabby.

## Build from source

```bash
npm install --legacy-peer-deps
npm run build
```

Copy `package.json` and `dist/` into `<Tabby config dir>/plugins/node_modules/tabby-control-tmux/`
(macOS: `~/Library/Application Support/tabby/plugins/node_modules/`) and restart Tabby.

## Notes

- Actions type commands into the active tab, so use them at a shell prompt.
- Requires `tmux` on the remote host (or use the install item).

## License

MIT

---
_Source: https://npm.io/package/tabby-control-tmux · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._