dvorka/hstr

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

C

4,466

688 commits

updated Sep 16, 2026

See the code

README

HSTR

Support on Open Collective GitHub Actions CI for Ubuntu Current release GitHub issues All releases downloads

Easily view, navigate and search your command history with shell history TUI suggest box for bash and zsh.

Shell History Suggest Box

Description

Are you looking for a command that you used recently? Do you want to avoid the need to write long commands over and over again? Are you looking for a tool that is able to manage your favorite commands?

HSTR (HiSToRy) is a command line utility that brings improved bash/zsh command completion from the history. It aims to make completion easier and more efficient than Ctrl-r.

HSTR can also manage your command history (for instance you can remove commands that are obsolete or contain a piece of sensitive information) or bookmark your favorite commands.

Installation

Install:

Build:

Tarball:

Check also packages for Linux and Unix.

Configuration

Configure HSTR just by running:

# bash
hstr --show-bash-configuration >> ~/.bashrc

# zsh
hstr --show-zsh-configuration >> ~/.zshrc

For detailed HSTR configuration documentation please refer to Configuration.

Tips

Troubleshooting:

Tips and tricks:

Perfect Software

Perfect software is not necessarily the best software - it is perfect simply because it does exactly what you want, how do you want it and when you want it. The YAGNI - You Aren't Gonna Need It - mantra protects software from wasting time and resources on implementing anything and everything.

The HSTR project is perfect to me. Even if project's main branch does not receive updates frequently, be sure that I use it every day - many many times. I add a small feature here or there or fix a bug. In other words, the project is not and will not be dead.

If you have any ideas, suggestions, news to share, or constructive criticism to share, do not hesitate to contact me! Please do not be offended if your GitHub issue or bug report is not implemeted - IAGNI.

In the News

Read about HSTR in:

Documentation

Check man page:

man hstr

User videos: Zack, Dvorka, Yayuuu, and Yu-Jie Lin.

Bugs

https://github.com/dvorka-oss/hstr/issues

bash
c
cli
command-history
history
linux
ubuntu
zsh

dvorka/hstr

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

C

4,466

688 commits

updated Sep 16, 2026

See the code

README

HSTR

Support on Open Collective GitHub Actions CI for Ubuntu Current release GitHub issues All releases downloads

Easily view, navigate and search your command history with shell history TUI suggest box for bash and zsh.

Shell History Suggest Box

Description

Are you looking for a command that you used recently? Do you want to avoid the need to write long commands over and over again? Are you looking for a tool that is able to manage your favorite commands?

HSTR (HiSToRy) is a command line utility that brings improved bash/zsh command completion from the history. It aims to make completion easier and more efficient than Ctrl-r.

HSTR can also manage your command history (for instance you can remove commands that are obsolete or contain a piece of sensitive information) or bookmark your favorite commands.

Installation

Install:

Build:

Tarball:

Check also packages for Linux and Unix.

Configuration

Configure HSTR just by running:

# bash
hstr --show-bash-configuration >> ~/.bashrc

# zsh
hstr --show-zsh-configuration >> ~/.zshrc

For detailed HSTR configuration documentation please refer to Configuration.

Tips

Troubleshooting:

Tips and tricks:

Perfect Software

Perfect software is not necessarily the best software - it is perfect simply because it does exactly what you want, how do you want it and when you want it. The YAGNI - You Aren't Gonna Need It - mantra protects software from wasting time and resources on implementing anything and everything.

The HSTR project is perfect to me. Even if project's main branch does not receive updates frequently, be sure that I use it every day - many many times. I add a small feature here or there or fix a bug. In other words, the project is not and will not be dead.

If you have any ideas, suggestions, news to share, or constructive criticism to share, do not hesitate to contact me! Please do not be offended if your GitHub issue or bug report is not implemeted - IAGNI.

In the News

Read about HSTR in:

Documentation

Check man page:

man hstr

User videos: Zack, Dvorka, Yayuuu, and Yu-Jie Lin.

Bugs

https://github.com/dvorka-oss/hstr/issues

bash
c
cli
command-history
history
linux
ubuntu
zsh

Project health

Overall

3.5/10

Maintained

4/10

Code review

0/10
OpenSSF Scorecard

Significant stargazers

(top 24 of 43)

Gajus Kuizinas

2,635 followers · starred May 2020

罗泽轩

982 followers · starred Oct 2020

Mike Danese

424 followers · starred Apr 2018

Patrick Schratz

341 followers · starred Apr 2022