Files
community-plugins/tmux-provider
mguandGitHub 8d183a1dcb feat: add tmux-provider plugin (#151)
* feat: add tmux-provider plugin

* fix: invalid thumbnail name

* fix: invalid translation keys

* docs: README updated to include launcher provider entry

Also fixed wording for requirements (validation failed for some reason?)
2026-07-29 15:00:07 -04:00
..

tmux Provider

A launcher provider plugin for searching running tmux sessions, or tmuxp configurations, and attaching the sessions.

Plugin

Field Value
ID dunarand/tmux-provider
Entry Launcher provider: provider
Launcher Prefix /tm

Requirements

tmuxp is completely optional. If you want tmuxp configurations to be included in the search, enable tmuxp option in the plugin settings.

Usage

Simply open your launcher and type the session you're looking for after the /tm prefix.

Selecting an entry and pressing Return / Enter launches the default terminal and attaches the tmux session.

Settings

Setting Type Default Description
use_tmuxp bool false Enables tmuxp configurations to be included in the search.

Notes

Limitations:

  • With the current implementation, we attach sessions via the following commands:

    • tmux:

      tmux attach -t <session>
      
    • tmuxp:

      tmuxp load <session>
      
  • The current implementation only utilizes tmuxp. Other tmux configuration tools such as tmuxinator will be added in the future.