history-search-multi-word
A ZSH plugin that binds Ctrl-R to a syntax-highlighted, multi-word history search with AND matching and context viewing.
What is history-search-multi-word?
history-search-multi-word is a ZSH plugin that enhances the shell's history search by binding Ctrl-R to a widget supporting multi-keyword AND searches. It solves the problem of inefficiently sifting through command history by allowing users to search with multiple terms simultaneously, with syntax highlighting and context viewing for better navigation.
ZSH users, system administrators, and developers who frequently use the command line and want faster, more precise history search capabilities.
Developers choose this plugin for its precise multi-word filtering, visual syntax highlighting, and seamless integration with existing ZSH setups, offering a significant productivity boost over the default single-term history search.
Overview
history-search-multi-word is a ZSH plugin that enhances the shell's history search functionality. It replaces the default Ctrl-R binding with a powerful widget that allows searching for multiple keywords simultaneously, returning only entries that match all terms. The plugin also provides syntax highlighting for matches and advanced features like context viewing.
Key Features
- Multi-Word AND Search — Searches ZSH history for entries containing all entered keywords, not just a single term.
- Syntax Highlighting — Highlights matched text and syntax elements (commands, paths, options) in search results for better readability.
- Context Viewing — Displays all occurrences of a command along with surrounding commands for better context.
- Customizable Appearance — Offers extensive styling options via zstyle settings and the HSMW_HIGHLIGHT_STYLES array to control colors, page size, and active entry effects.
- Plugin Manager Agnostic — Works with Zinit, Antigen, Oh-My-Zsh, Zgen, Sheldon, or manual installation.
Philosophy
The plugin prioritizes efficiency and clarity in command-line history navigation, providing a fast, visual, and precise search experience that respects the user's workflow and integrates seamlessly with other ZSH plugins.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
