#fuzzy-search #history #command #clipboard

app history-fuzzy-search

A tool for fuzzy searching through command history

4 releases (breaking)

0.4.0 Dec 22, 2024
0.3.0 Dec 22, 2024
0.2.0 Dec 22, 2024
0.1.0 Dec 22, 2024

#9 in #history

Download history 222/week @ 2024-12-20 12/week @ 2024-12-27

234 downloads per month

MIT license

95KB
127 lines

History Fuzzy Search (hfs)

history-fuzzy-search (hfs) is a command line tool that enhances your terminal experience by enabling quick and efficient fuzzy searching through your command history. It supports both Bash and Zsh shells.

Features

  • Reads command history from Bash and Zsh history files.
  • Provides fuzzy search to filter through command history.
  • User-friendly interface with keyboard navigation.
  • Copies selected commands to the clipboard for easy pasting.

Usage

After installing hfs, invoke it from the terminal and start typing to search your command history.

Screenshot

  • Use the Up/Down arrow keys to navigate through the search results.
  • Press Enter to copy the selected command to the clipboard.
  • Press Esc to exit the interface.

Installation

Install hfs to ~/.cargo/bin and ensure ~/.cargo/bin is included in your $PATH to run hfs directly from the terminal.

Install via Cargo

cargo install history-fuzzy-search

Install via Git

git clone https://github.com/jaylu/history-fuzzy-search.git
cd history-fuzzy-search
cargo build --release
cargo install --path .

Development

To build and run hfs locally:

# Build the project
cargo build

# Run the project
cargo run

# Install the `hfs` binary in ~/.cargo/bin for local testing
cargo install --path .

Contributing

Contributions are welcome! Open an issue or submit a pull request for enhancements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Dependencies

~4.5–6.5MB
~94K SLoC