termsearch

Crates.iotermsearch
lib.rstermsearch
version0.3.1
created_at2025-01-04 13:57:24.183853+00
updated_at2025-01-30 07:21:51.774084+00
descriptionA minimalist and super fast terminal history search tool.
homepagehttps://github.com/zenoxygen/termsearch
repositoryhttps://github.com/zenoxygen/termsearch
max_upload_size
id1503922
size49,781
(zenoxygen)

documentation

README

termsearch

pipeline crates.io

A minimalist and super fast terminal history search tool, that uses a weighted scoring system to rank commands.

  • Recency: more recent commands are given higher priority
  • Frequency: commands used more frequently are given higher priority

Note: it only works with zsh on Linux for now.

Usage

Initialize termsearch

Add the following line to your ~/.zshrc file:

eval "$(termsearch init)"

This rebinds Ctrl+R to use termsearch for searching your command history.

Search for a command

termsearch search
  • Up/Down and Shift+Tab/Tab navigate up/down through the search results.
  • Enter selects the highlighted command and pastes it into the terminal's input line.
  • Ctrl+C, Ctrl+D, Esc cancel the search.

Options

-m, --max-history <MAX_HISTORY>  Maximum number of history lines to read [default: 10000]
-r, --max-results <MAX_RESULTS>  Maximum number of results to display [default: 10]

Installation

From crates.io (recommended)

cargo install termsearch

From source

cargo install --path .

Uninstallation

cargo uninstall termsearch

Debug

Set log level with TERMSEARCH_LOG environment variable:

export TERMSEARCH_LOG=debug
Commit count: 12

cargo fmt