hm
Command line history manager for bash.
About
History manager provides an alternative command line history storage with the ability to select a subset of commands and load it into the current Bash session so the Ctrlr search is performed on the selected subset. It has an SQLite database under the hood and, besides the executed command line, stores time, working directory, returned code and a unique terminal session identifier. All additional information may be used as a selection criterion.
Motivation
There are two main usage scenarios:
Recover history
It is a quite common issue when you need to repeat some actions with a previously developed project but don't remember exact commands you have used for it. History manager provides a way to recover command history related to the specific directory, particular session or both.
Synchronize history
The recovery of a history can be assumed as synchronization between previously existed session and the current one. But it may be also useful to synchronize histories of several simultaneously opened terminal sessions so any executed command can be easily shared. History manager solves this by using the same command selection mechanism as for the history recovery case.
Installation
Install release:
Install latest version in development:
Configuration
Configuration of the history manager is performed by adding it's wrapper scripts to the .bashrc
:
hm-db configure ~/.bashrc
To enable hm
in the current session source the .bashrc
:
. ~/.bashrc
More details are here.
Usage
Per-directory history recovery
Recovering command history related to the specific directory is performed with:
hm -d /path/of/interest
or for the current working directory:
hm -d
Terminal session command history recovery
To set a terminal session name and to recover the command history related to this name run the following:
hm -s "Session Name"
To synchronize history with the database using the previously given name:
hm -s
More usage examples are here.
Acknowledgements
History manager utilizes the following thirdparty projects: