# Install tmux-fingers with Homebrew

Copy pasting in terminal with vimium/vimperator like hints. Version 2.7.1 via Homebrew; verified 2026-07-16.

## Install

```sh
sudo av install brew:tmux-fingers
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tmux-fingers
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:tmux-fingers
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tmux-fingers>
- **Version:** 2.7.1
- **Source summary:** Copy pasting in terminal with vimium/vimperator like hints
- **Homepage:** <https://github.com/Morantron/tmux-fingers>
- **Repository:** <https://github.com/Morantron/tmux-fingers>
- **Upstream docs:** <https://github.com/Morantron/tmux-fingers>
- **License:** MIT
- **Source archive:** <https://github.com/Morantron/tmux-fingers/archive/refs/tags/2.7.1.tar.gz>
- **Last updated:** 2026-07-16T09:42:31Z
- **Generated:** 2026-07-26T07:20:29+00:00

## Executables

- tmux-fingers (cli)
- tmux-fingers (alias)

## Dependencies

- bdw-gc
- pcre2
- tmux

## Build dependencies

- crystal

## Install behavior

- Post-install hook: not defined
- Caveats: To initialize tmux-fingers add this to your tmux configuration file (~/.tmux.conf or $XDG_CONFIG_HOME/tmux/tmux.conf): run 'tmux-fingers load-config'
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-26
- Package-manager version: 2.7.1
- Package-manager updated: 2026-07-16
- Local data: ok
- Upstream repository: https://github.com/Morantron/tmux-fingers
- Upstream latest detected: 2.7.1 (current)
## Project history and usage

tmux-fingers is a tmux productivity plugin and CLI that overlays keyboard hints on recognizable text in a terminal pane, letting users copy, paste, open, or jump to a match with few keystrokes. Its interaction model is explicitly inspired by the keyboard hint systems in Vimium and Vimperator.

### Project history

The public repository began in 2016 as a tmux plugin for hint-driven selection of paths, hashes, addresses, and other terminal text. Version 1.0 in 2020 added system clipboard and opener integration, multiple selection, modifier-specific actions, and configurable keyboard layouts.

Version 2.0 in September 2023 rewrote the implementation in Crystal, switched pattern matching from ERE to PCRE, and expanded styling and capture support. Subsequent releases added jump mode, Termux and WSL improvements, cross-pane targeting, tighter system-clipboard controls, performance work, and standalone binaries for selected Linux and macOS platforms.

### Adoption history

tmux-fingers is distributed through Tmux Plugin Manager, manual repository installation, standalone release binaries, and Homebrew on macOS. The official GitHub repository has accumulated roughly 1,400 stars, reflecting durable adoption among keyboard-driven tmux users.

### How it is used

Users normally add `Morantron/tmux-fingers` to the TPM plugin list in `~/.tmux.conf`, then press the tmux prefix followed by `F`. The plugin highlights built-in patterns such as file paths, URLs, SHAs, IP addresses, UUIDs, hexadecimal values, Kubernetes resources, and git status or diff paths; choosing a hint copies the matched text.

Options in `~/.tmux.conf` customize activation keys, regex patterns, actions, colors, hint position, keyboard layout, clipboard behavior, and bindings. Modifier keys can paste or open matches, Tab enables multi-selection, and the exposed CLI can be bound directly to arbitrary tmux target panes.

### Why package nerds care

tmux-fingers packages a browser-style hinting workflow as a composable tmux plugin while also shipping a compiled CLI. It is interesting to terminal-tool users because it bridges tmux configuration, PCRE-based recognition, native clipboard and opener integration, TPM installation, Homebrew packaging, and prebuilt binaries without requiring a graphical terminal feature.

### Timeline

- 2016: The public tmux-fingers repository was created.
- 2020: Version 1.0 added OS clipboard integration, multi-select, modifier actions, and keyboard layouts.
- 2023: Version 2.0 rewrote the tool in Crystal and adopted PCRE patterns.
- 2024: The 2.x series added jump mode, Termux support, and XDG state directories for logs.
- 2026: Version 2.7 improved performance and expanded standalone binary support.

### Related projects

- tmux provides the multiplexer and configuration surface in which tmux-fingers runs.
- Tmux Plugin Manager is the recommended plugin installation mechanism.
- tmux-copycat is acknowledged by the author as a major inspiration for the predefined-search workflow.
- Vimium and Vimperator inspired the letter-hint interaction model.

### Sources

- <https://api.github.com/repos/Morantron/tmux-fingers>
- <https://github.com/Morantron/tmux-fingers>
- <https://github.com/Morantron/tmux-fingers/blob/master/CHANGELOG.md>


## Security Notes

No matching local secret-handling manifest was found for tmux-fingers. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.tmux.conf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tmux-fingers
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [pcre2](https://www.automicvault.com/pkg/brew/pcre2/) - Runtime dependency declared by Homebrew.
- [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew.
- [crystal](https://www.automicvault.com/pkg/brew/crystal/) - Build dependency declared by Homebrew.
- [clippy](https://www.automicvault.com/pkg/brew/clippy/) - Shares av.db curated category or tags: cli, clipboard, productivity, terminal.
- [doxx](https://www.automicvault.com/pkg/brew/doxx/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [eureka](https://www.automicvault.com/pkg/brew/eureka/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [harsh](https://www.automicvault.com/pkg/brew/harsh/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [intelli-shell](https://www.automicvault.com/pkg/brew/intelli-shell/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [nnn](https://www.automicvault.com/pkg/brew/nnn/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [sheets](https://www.automicvault.com/pkg/brew/sheets/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [sigi](https://www.automicvault.com/pkg/brew/sigi/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [tmux-xpanes](https://www.automicvault.com/pkg/brew/tmux-xpanes/) - Package names and metadata indicate a similar tool family. Shared terms: cli, productivity, terminal, tmux.
- [tmux-sessionizer](https://www.automicvault.com/pkg/brew/tmux-sessionizer/) - Package names and metadata indicate a similar tool family. Shared terms: cli, productivity, tmux.

## Combined YAML source

View the package source record on GitHub. [combined/tmux-fingers.yml](https://github.com/automic-vault/db/blob/main/combined/tmux-fingers.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
