dvorka-oss/hstr logo

dvorka-oss/hstr

Free

Bash and Zsh shell history TUI suggest box - easily view, navigate, search and manage your command history.

FreeFree tier
Inputs: textOutputs: text
Type
Open Source

About dvorka-oss/hstr

HSTR (Hi STo R y) is a command line utility that provides an improved bash and zsh command history completion experience via a terminal user interface (TUI) suggest box. It allows users to easily view, navigate, search, and manage their command history, offering a more efficient alternative to the traditional Ctrl-r. HSTR supports removing obsolete or sensitive commands from history, bookmarking favorite commands, and using tags for fast lookup. It is available as a package for many Linux distributions, macOS, and other Unix-like systems, and can also be built from source. Configuration is straightforward, requiring only that users run a simple command to generate the necessary shell integration code.

Key Features

Shell history TUI suggest box for bash and zsh
Improved command completion more efficient than Ctrl-r
View, navigate, and search command history
Manage history: remove obsolete or sensitive commands
Bookmark favorite commands
Command tags for fast lookup
Hide commands from history
Cross-platform: Linux, macOS, WSL, Cygwin, BSD
Configuration via simple command (--show-bash-configuration / --show-zsh-configuration)
Open source under Apache 2.0 license

Pros & Cons

Pros
  • More efficient command history search than traditional Ctrl-r
  • Helps maintain command history hygiene by removing unwanted entries
  • Open source and free with permissive Apache 2.0 license
  • Supports both bash and zsh shells
  • Available via package managers for many platforms
  • Customizable behavior and appearance via configuration
Cons
  • Only works with bash and zsh (not fish or other shells)
  • Terminal user interface may not suit all users (no GUI)
  • Potential issues with command insertion in some terminal emulators (as per troubleshooting note)
  • Requires initial configuration to integrate with shell

Best For

Quickly recall recently used commandsAvoid retyping long or complex commandsManage and clean up command history to remove sensitive dataCurate and bookmark frequently used commandsSearch command history by keywords or tags

FAQ

What shells does HSTR support?
HSTR supports bash and zsh shells.
How do I install HSTR?
HSTR can be installed via package managers for many Linux distributions (Ubuntu, Debian, Fedora, etc.), macOS, FreeBSD, and more. It can also be built from source on any Linux distribution or Windows Subsystem for Linux.
How do I configure HSTR?
Run `hstr --show-bash-configuration` for bash or `hstr --show-zsh-configuration` for zsh and append the output to your ~/.bashrc or ~/.zshrc respectively.
Is HSTR free?
Yes, HSTR is free and open source under the Apache 2.0 license.