npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

tabby-tmux

v1.6.1

Published

Tmux Control Mode support for Tabby

Readme

tabby-tmux

中文

Build npm version License: MIT

A Tabby plugin that provides tmux Control Mode integration, inspired by iTerm2 tmux Integration.

Features

  • Native UI integration — Maps tmux windows and panes into native Tabby components
  • Session persistence — tmux sessions survive Tabby restarts; reconnect via tmux -CC attach
  • Window bar — Collapsible bottom bar for switching tmux windows, with support for creating new windows and disconnecting
  • Layout sync — Automatically syncs tmux layout into Tabby SplitTab

tmux-pane

Requirements

tmux 3.1 or later must be installed on the machine where the terminal session runs. For SSH connections, this means the remote host. The plugin uses capture-pane -N, which was added in tmux 3.1; older versions such as 3.0a can display capture-pane usage errors when opening panes.

Check the installed version with:

tmux -V

Linux: upgrading with a static binary

If your distribution's package repository provides an older tmux, you can use a prebuilt Linux static binary from the third-party build-static-tmux Releases instead of compiling tmux and its dependencies yourself.

Choose a recent stable version matching your machine's architecture (uname -m), download and extract it if needed, then install the binary as tmux in a directory on your PATH. For example, replace /path/to/downloaded/tmux below with the downloaded binary's actual path:

mkdir -p "$HOME/.local/bin"
install -m 755 /path/to/downloaded/tmux "$HOME/.local/bin/tmux"
export PATH="$HOME/.local/bin:$PATH"
command -v tmux
tmux -V

Add the export PATH=... line to your shell's startup file so new terminal sessions also use the upgraded binary.

Upgrading the executable does not upgrade an already-running tmux server. Check the version of the server you are connecting to with:

tmux display-message -p '#{version}'

If the server is still older than 3.1, save your work and finish the tasks in its sessions before restarting it with the new binary, then re-enter tmux mode.

Installation

Via Tabby Settings

  1. Open Tabby → Settings → Plugins
  2. Search for tabby-tmux
  3. Click Install

Via command line

cd <tabby-plugins-dir>
npm install tabby-tmux

Usage

  1. Open any terminal tab in Tabby
  2. Right-click the tab → Enter Tmux Mode
  3. The bottom window bar appears — switch between tmux windows and panes from there
  4. Right-click → Exit Tmux Mode to detach

Configuration

History restoration limit

Set Settings → Tmux → History rows to restore to limit each pane to its most recent history rows (default: 5000). The limit counts tmux physical rows and excludes the current screen. Set it to 0 to restore only the current screens. Changes apply to the next restoration or attach and do not delete history from tmux.

The actual number restored also depends on how much history tmux still holds and Tabby's terminal scrollback capacity. tmux defaults to a history-limit of 2000, so a plugin limit of 5000 may restore only about 2000 rows. The plugin does not change this tmux setting and cannot recover history that tmux has already discarded.

To retain more history, add the following to ~/.tmux.conf on the machine running tmux (the remote host for SSH sessions), then load it with tmux source-file ~/.tmux.conf:

set -g history-limit 50000

In tmux 3.4, changing history-limit applies only to newly created panes; existing panes keep their original capacity even after reattaching. Create a new window or pane after loading the configuration to use the larger capacity. Also ensure Tabby's terminal scrollback capacity is at least the desired restoration limit.

Check each pane's currently retained history and actual capacity with:

tmux list-panes -a -F '#{pane_id} history_size=#{history_size} history_limit=#{history_limit}'

Right-click behavior

With Settings → Terminal → "On right-click" set to Menu, right-clicking inside a tmux pane opens its context menu, including tmux actions and menus contributed by other plugins.

Built-in copy/paste, pane rename/label, close/split, toolbar/focus, switch-profile, save-as-profile, task/activity notifications, disconnect/reconnect, SFTP, and new-terminal/profile menus are automatically hidden in tmux panes and omitted from the settings list. Tmux's own actions remain available.

Use Settings → Tmux → Excluded pane menus to exclude other menu groups by source. Checked groups are skipped before their menus are requested. Resetting exclusions re-enables these other groups while keeping the built-in menus hidden.

Other plugin menus are enabled by default, but displaying a menu does not guarantee that its actions work with tmux. Exclusions apply the next time you open a pane menu; normal terminal and tab-header menus are unaffected. Legacy terminal-menu plugins are listed separately too. Sources use the plugin name, menu API, and registration position as their ID, so minified class names do not collide. Menu titles are read from provider results when you open a pane menu and saved for use after restart, even when a source is excluded. Until a title has been discovered, settings show the plugin name. A plugin update that reorders its menu providers may require reselecting exclusions.

If you set "On right-click" to Paste or Clipboard in Tabby settings, this plugin will respect that choice:

  • Quick right-click → performs the configured action (paste from clipboard / copy selection)
  • Long press (≥ 250 ms) → still opens the tmux pane context menu, so all tmux features remain accessible

Tip: If the tmux menu feels hard to reach after changing the setting, hold the right mouse button down for a moment before releasing.

Keyboard shortcuts

In tmux mode, shortcuts are layered (see doc/DESIGN_KEYBINDINGS.md):

  • Pane operations reuse Tabby's native shortcuts — they act on the tmux pane directly (the plugin translates them into tmux commands):
    • Split: Ctrl+Shift+S (right) / Ctrl+Shift+D (down)
    • Pane navigation: Ctrl+Alt+Arrow
    • Zoom pane (maximize): Ctrl+Alt+Enter — press again to unzoom (⌘+⌥+Enter on macOS)
  • Window operations are tmux-mode-specific shortcuts (defaults below; rebind in Tabby Settings → Hotkeys):
    • Previous / next window: Ctrl+Shift+[ / Ctrl+Shift+]
    • Go to window 1–9: Ctrl+Shift+1..9
    • New window: Ctrl+Shift+B
    • Toggle tmux mode: Ctrl+Shift+X — exits tmux mode when connected; enters it from the active terminal tab when idle
  • Tabby top-level shortcuts (switch/close tabs, etc.) are unchanged

All shortcuts — including the plugin-specific ones — are configured in Tabby Settings → Hotkeys; the plugin settings page intentionally has no shortcut form, to avoid a second conflicting entry point.

Compatibility

trzsz

This plugin is fully compatible with the tabby-trzsz plugin, enabling file transfer (trz/tsz) and drag-and-drop upload over tmux panes.

Install both plugins and they work together automatically:

cd <tabby-plugins-dir>
npm install tabby-tmux tabby-trzsz

Note: When uploading files over WebSocket terminals (e.g. via tabby-ws-term), use trzsz -B 10K to improve compatibility.

Development

pnpm install
pnpm run watch  # watch mode

# Launch Tabby with the plugin loaded
TABBY_PLUGINS=$(pwd) tabby --debug

Run the restoration performance benchmarks (requires local tmux ≥ 3.1 and Vim):

pnpm run test:performance

The benchmarks check transfer volume, restoration time, and screen correctness with large histories, multiple windows, continuous output, and Vim. See the performance analysis for reproduction steps, budgets, and measurements.

License

MIT