tmux-copycat 0,0 travis-ci docker vagrant

A plugin that enhances tmux search

Tmux copycat

Build Status

This plugin enables:

  • regex searches
  • search result highlighting
  • predefined searches

Predefined searches are plugin killer feature. It speeds the workflow and reduces mouse usage with Tmux.

It works even better when paired with tmux yank.

Tested and working on Linux, OSX and Cygwin.

Note: new version 2.0 uses extended regexes! Regex character escaping with backslashes \ isn’t required anymore.


screencast screenshot


  • prefix + / - regex search (strings work too)

Example search entries:

  • foo - searches for string foo
  • [0-9]+ - regex search for numbers

Grep is used for searching.
Searches are case insensitive.

Predefined searches

  • prefix + ctrl-f - simple *f*ile search
  • prefix + ctrl-g - jumping over *g*it status files (best used after git status command)
  • prefix + alt-h - jumping over SHA-1 hashes (best used after git log command)
  • prefix + ctrl-u - *u*rl search (http, ftp and git urls)
  • prefix + ctrl-d - number search (mnemonic d, as digit)
  • prefix + alt-i - *i*p address search

These start “copycat mode” and jump to first match.

“Copycat mode” bindings

These are enabled when you search with copycat:

  • n - jumps to the next match
  • N - jumps to the previous match

To copy a highlighted match:

  • Enter - if you’re using Tmux vi mode
  • ctrl-w or alt-w - if you’re using Tmux emacs mode

Copying a highlighted match will take you “out” of copycat mode. Paste with prefix + ] (this is Tmux default paste).

Copying highlighted matches can be enhanced with tmux yank.

Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'tmux-plugins/tmux-copycat'

Hit prefix + I to fetch the plugin and source it. You should now be able to use the plugin.

Optional (but recommended) install gawk via your package manager of choice for better UTF-8 character support.

Manual Installation

Clone the repo:

$ git clone ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/copycat.tmux

Reload TMUX environment with: $ tmux source-file ~/.tmux.conf. You should now be able to use the plugin.

Optional (but recommended) install gawk via your package manager of choice for better UTF-8 character support.


This plugin has some known limitations. Please read about it here.


  • Most of the behavior of tmux-copycat can be customized via tmux options. Check out the full options list.
  • To speed up the workflow you can define new bindings in .tmux.conf for searches you use often, more info here

Other goodies

tmux-copycat works great with:

  • tmux-yank - enables copying highlighted text to system clipboard
  • tmux-open - a plugin for quickly opening a highlighted file or a url
  • tmux-continuum - automatic restoring and continuous saving of tmux env

You might want to follow @brunosutic on twitter if you want to hear about new tmux plugins or feature updates.

Test suite

This plugin has a pretty extensive integration test suite that runs on travis.

When run locally, it depends on vagrant. Run it with:

# within project top directory
$ ./run-tests

By default tests run in 2 vagrant VMs: ubuntu and centos.

Contributions and new features

Bug fixes and contributions are welcome.

Feel free to suggest new features, via github issues.

If you have a bigger idea you’d like to work on, please get in touch, also via github issues.



Related Repositories



A plugin that enhances tmux search ...

Top Contributors

bruno- toupeira soli pmalek grota metcalfc s3rvac qstrahl vellvisher f440


-   v2.1.0 zip tar
-   v2.0.0 zip tar
-   v1.1.0 zip tar
-   v1.0.0 zip tar
-   v0.1.0 zip tar
-   v0.0.7 zip tar
-   v0.0.6 zip tar
-   v0.0.5 zip tar
-   v0.0.4 zip tar
-   v0.0.3 zip tar
-   v0.0.2 zip tar
-   v0.0.1 zip tar