https://github.com/dvorka-oss/hstr
Bash and Zsh shell history TUI suggest box - easily view, navigate, search and manage your command history.
https://github.com/dvorka-oss/hstr
bash c cli command-history history linux ubuntu zsh
Last synced: about 1 hour ago
JSON representation
Bash and Zsh shell history TUI suggest box - easily view, navigate, search and manage your command history.
- Host: GitHub
- URL: https://github.com/dvorka-oss/hstr
- Owner: dvorka-oss
- License: apache-2.0
- Created: 2013-12-02T22:47:51.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2026-05-29T18:08:10.000Z (about 1 month ago)
- Last Synced: 2026-06-30T09:16:49.104Z (3 days ago)
- Topics: bash, c, cli, command-history, history, linux, ubuntu, zsh
- Language: C
- Homepage: https://projects.mindforger.com/
- Size: 2.43 MB
- Stars: 4,442
- Watchers: 50
- Forks: 237
- Open Issues: 185
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog
- Funding: .github/FUNDING.yaml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# HSTR
[](https://opencollective.com/dvorka-floss-lab)
[](https://github.com/dvorka-oss/hstr/actions)
[](https://github.com/dvorka-oss/hstr/releases)
[](https://github.com/dvorka-oss/hstr/issues)
[](https://github.com/dvorka-oss/hstr/releases)
[](https://github.com/dvorka-oss/hstr/blob/master/LICENSE)
Easily view, navigate and search your **command history** with shell history TUI suggest box for
[bash](https://www.gnu.org/software/bash/) and [zsh](CONFIGURATION.md#zsh-history-settings).
[](http://www.youtube.com/watch?v=sPF29NyXe2U)
## 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 (**H**i**ST**o**R**y) 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.
## Packages
## Installation
Install:
* [Ubuntu](INSTALLATION.md#ubuntu)
* [Debian](INSTALLATION.md#debianmint)
* [Mint](INSTALLATION.md#debianmint)
* [Fedora](INSTALLATION.md#fedorarhelcentosscientific)
* [CentOS](INSTALLATION.md#fedorarhelcentosscientific)
* [RHEL](INSTALLATION.md#fedorarhelcentosscientific)
* [Scientific Linux](INSTALLATION.md#fedorarhelcentosscientific)
* [openSUSE](INSTALLATION.md#opensuse)
* [Gentoo](INSTALLATION.md#gentoo)
* [Alpine Linux](INSTALLATION.md#alpine-linux)
* [Arch](INSTALLATION.md#archmanjaro-linux)
* [Manjaro Linux](INSTALLATION.md#archmanjaro-linux)
* [FreeBSD](INSTALLATION.md#freebsd)
* [Slackware Linux](INSTALLATION.md#slackware)
* [Void Linux](INSTALLATION.md#void-linux)
* [Milis Linux](INSTALLATION.md#milis-linux)
* [Haiku OS](INSTALLATION.md#haiku-os)
* [macOS](INSTALLATION.md#macos)
* [nix package manager](INSTALLATION.md#nix-package-manager)
* [Guix package manager](INSTALLATION.md#guix-package-manager)
* [MPR package manager](INSTALLATION.md#mpr-package-manager)
Build:
* [build on any Linux distro](INSTALLATION.md#build-on-any-linux-distro)
* [build snap](INSTALLATION.md#snap)
* [build on Ubuntu](INSTALLATION.md#build-on-ubuntu)
* [build on Debian](INSTALLATION.md#build-on-debian)
* [build on Fedora](INSTALLATION.md#build-on-fedora)
* [build on Windows Subsystem for Linux (WSL)](INSTALLATION.md#build-on-wsl)
* [build on Cygwin](INSTALLATION.md#build-on-cygwin)
* [build on macOS](INSTALLATION.md#build-on-macos)
Tarball:
* [build and install tarball](INSTALLATION.md#build-and-install-tarball)
Check also [packages](https://pkgs.org/search/?q=hstr) for Linux and Unix.
## Configuration
Configure HSTR just by running:
```bash
# bash
hstr --show-bash-configuration >> ~/.bashrc
# zsh
hstr --show-zsh-configuration >> ~/.zshrc
```
For detailed HSTR configuration documentation please refer to [Configuration](CONFIGURATION.md).
## Tips
Troubleshooting:
* [Commands chosen in HSTR are not inserted to terminal](INSTALLATION.md#hstr-2x-to-3x-ioctl--tiocsti)
Tips and tricks:
* [How to hide commands from your history](./TIPS.md)
* [How to use command tags for fast lookup](./TIPS.md)
* [How to curate your favorite commands](./TIPS.md)
## In the News
Read about HSTR in:
* [LinuxMagazine](http://www.linux-magazine.com/Issues/2014/164/Bash-History-on-Steroids)
* [UbuntuGeek](http://www.ubuntugeek.com/tag/hstr-bash-history)
* [DebianAdmin](http://www.debianadmin.com/hstr-easily-view-navigate-search-and-use-your-command-history-with-shell-history.html)
* [Tuxdiary](http://tuxdiary.com/2015/02/17/hstr/)
* [Softpedia](http://linux.softpedia.com/get/Terminals/BASH-Command-History-Completion-103155.shtml)
* [OSTechNix](https://www.ostechnix.com/hstr-easily-view-navigate-search-manage-commandline-history/)
## Documentation
Check man page:
```bash
man hstr
```
User videos: [Zack](https://www.youtube.com/watch?v=Qd75pIeQkH8), [Dvorka](https://www.youtube.com/watch?v=sPF29NyXe2U), [Yayuuu](https://www.reddit.com/r/commandline/comments/1lo5up5/hstr_tiny_bash_script_that_helps_you_browse_and/), and [Yu-Jie Lin](https://www.youtube.com/watch?v=Qx5n_5B5xUw).
## Bugs
https://github.com/dvorka-oss/hstr/issues