By name: hstr description: Use this skill when the user wants to search, browse, or manage their bash/zsh command history interactively or via CLI.
hstr Plugin
Shell history suggest box for bash and zsh — easily view, navigate, search, and manage your command history with an interactive TUI.
Commands
History
hstr history search— Open interactive history search TUIhstr config bash— Show bash configuration snippethstr config zsh— Show zsh configuration snippet
Utility
hstr _ _— Passthrough to hstr CLI
Usage Examples
- "Search my command history for docker commands"
- "Show me my bash history interactively"
- "Configure hstr for zsh"
Installation
brew install hstr
Or via apt:
sudo apt install hstr
Configuration
Add hstr to your shell (bash):
hstr --show-bash-configuration >> ~/.bashrc
Or for zsh:
hstr --show-zsh-configuration >> ~/.zshrc
Then reload your shell:
exec $SHELL
Examples
# Open interactive history search
hstr history search
# Search history non-interactively for docker commands
hstr history search --non-interactive --keywords docker
# Get bash configuration
hstr config bash
# Get zsh configuration
hstr config zsh
# Passthrough: show version
hstr _ _ --version
# Passthrough: show help
hstr _ _ --help
Key Features
- Interactive TUI — Fuzzy search through command history with arrow keys
- Non-interactive mode — Filter history programmatically with keywords
- Shell integration — Replace Ctrl-r with a full-screen history browser
- Bookmark support — Favorite frequently used commands
- History management — Remove obsolete or sensitive commands from history