Bash history put into sqlite so it can be searched
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Albert S. d0e07640e8 Update 8 months ago
liner Implement mode for reverse search in cwd 8 months ago
.gitignore Init+ minor improvements 1 year ago
LICENSE add LICENSE 1 year ago
Makefile Add 'version' command 1 year ago Update 8 months ago
go.mod Implement bash CTRL-R reverse history 10 months ago
go.sum Implement bash CTRL-R reverse history 10 months ago
history.go Implement mode for reverse search in cwd 8 months ago
main.go Implement --today 8 months ago


hs9001 (history search 9001) is an easy, quite simple bash history enhancement. It simply writes all your bash commands into an sqlite database. You can then search this database.

It improves over bash's built-in history mechanism as it'll aggregate the shell history of all open shells, timestamp them and also record additional information such as the directory a command was executed in.

Usage / Examples

hs [search terms]

You can further filter with options like -cwd, -after and so on... For a full list, see -help.

hs -cwd . 

Lists all commands ever entered in this directory

hs -today -cwd . git

Lists all git commands in the current directory which have been entered today.

Also, it (by default) replaces bash's built-in CTRL-R mechanism, so hs9001's database will be used instead of bash's limited history files.

When in reverse-search mode, you can only search the history of the current directory by pressing CTRL+A and then "w".


Debian / Ubuntu

Latest release can be installed using apt

curl -s | sudo apt-key add -
echo "deb default main" | sudo tee /etc/apt/sources.list.d/quitesimple.list
sudo apt-get update
sudo apt-get install hs9001


wget -O /etc/apk/
echo "" >> /etc/apk/repositories
apk update
apk add hs9001

From source

go build
#move hs9001 to a PATH location

Add this to .bashrc

eval "$(hs9001 bash-enable)"

This will also create a hsalias so you have to type less in everyday usage.

By default, every system user gets his own database. You can override this by setting the environment variable for all users that should write to your unified database.

export HS9001_DB_PATH="/home/db/history.sqlite"