gitwtfhub

wtf is tmux-flash?

andrevicencio/tmux-flash — explained in plain English

Analysis updated 2026-05-18

7PythonAudience · developerComplexity · 2/5Setup · easy

TL;DR

A tmux plugin that adds flash.nvim-style jump navigation to copy mode, letting you type a few characters and jump straight to a labeled match.

Mindmap

mindmap
  root((repo))
    What it does
      Incremental search with labels
      Jump to visible matches
      Extends active selection
    Tech stack
      Python
      tmux
      Shell scripts
    Use cases
      Jump to text in a terminal pane
      Select text without arrow keys
      Speed up copy mode navigation
    Audience
      Terminal power users
      Developers
    Setup
      Install via TPM or manually
      Needs tmux 3.1 plus and Python 3

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Jump to any visible text in a terminal pane by typing a few characters

REASON 2

Extend an active copy-mode selection to a labeled match instead of losing it

REASON 3

Navigate a terminal pane faster than scrolling or arrow keys

REASON 4

Use flash.nvim-style search inside tmux without needing Neovim

What's in the stack?

PythontmuxShell

How it stacks up

andrevicencio/tmux-flashalx-code/lingbot-video-1.3b-fp8andrewbergman/kuma-importer
Stars777
LanguagePythonPythonPython
Setup difficultyeasymoderate
Complexity2/52/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires tmux 3.1+, Python 3, and vi-style key bindings enabled in copy mode.

License details are not stated in the README excerpt.

Wtf does this do

tmux-flash is a plugin for tmux, a terminal multiplexer that lets you split your terminal into panes and switch between them, that brings a faster way to jump around and select text inside a terminal pane. It copies a navigation style from a popular text editor plugin called flash.nvim: you start typing a few characters, and every matching spot on screen gets a small label next to it that narrows as you type more. Pressing that label jumps your cursor straight there. If you already had a text selection going, the jump extends that selection to the new spot instead of replacing it. The README explains this did not really exist for tmux before. Other similar tools either only read a single typed character at a time due to a technical limitation, cancel your existing text selection when they jump, or only highlight specific patterns like web addresses or file paths rather than letting you search for any text you type. tmux's own built in search also searches your entire terminal history rather than just what is currently visible on screen, and does not use jump labels at all. Under the hood, since tmux normally cannot feed a running script a live stream of your keystrokes, tmux-flash works around this by temporarily swapping in a small helper program that takes over reading your keystrokes directly, while your original pane and its selection sit untouched in the background. Once you pick a match, the helper moves your real cursor there using ordinary cursor movements, which is what allows an existing selection to stretch to the new position rather than being lost. Installation is done either through the Tmux Plugin Manager or by cloning the repository manually and loading it from your tmux configuration file. It needs a reasonably recent version of tmux, Python 3, which comes preinstalled on macOS and most Linux systems, and vi style key bindings turned on in tmux's copy mode. The trigger key and the set of label characters used can both be customized in your tmux configuration.

Yoink these prompts

Prompt 1
Help me install tmux-flash using the Tmux Plugin Manager and set it up in my tmux.conf
Prompt 2
Explain how tmux-flash extends an active selection when I jump to a labeled match
Prompt 3
Walk me through customizing the trigger key and label alphabet for tmux-flash
Prompt 4
Show me the key sequence to select and yank text using tmux-flash's flash search

Frequently asked questions

wtf is tmux-flash?

A tmux plugin that adds flash.nvim-style jump navigation to copy mode, letting you type a few characters and jump straight to a labeled match.

What language is tmux-flash written in?

Mainly Python. The stack also includes Python, tmux, Shell.

What license does tmux-flash use?

License details are not stated in the README excerpt.

How hard is tmux-flash to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tmux-flash for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.