This document is an unfinished draft.
Table of contents:
* Source code
* Mac OS
* Keyboard shortcut
* Shell specific
* History views
* History filtering
* Choosing a command
* Favorite commands
* Delete last command
`hh` is typically started by pressing <kbd>Ctrl-r</kbd> after
you configure it for this shorcut for your shell. However,
you can run it as a normal program just by typing:
It opens a page with a history view (ranking view is default).
Alternatively you can run `hh` in non-interactive mode -
commands are just listed on standard output based on history
Filtering pattern can be optionally specified as well:
hh -i git
Prints history items containing `git` to standard output and
### History filtering
When `hh` starts in interative mode, a view of commands
is shown. This list of commands can be filtered just by typing
a string pattern.
### Choosing a command
When you filtered the view of history items enough, you can
move around it with `UP` and `DOWN` arrow keys. Selected history
items is highlighted. Once you are done with your choice:
* press `ENTER` to choose the command and execute it
* or press `TAB` or `RIGHT` arrow key to choose the command and edit it on command line after exiting `hh`
* or press `LEFT` arrow key to choose the command and open it in editor (Bash `fc` i.e. fix command)
`hh` allows you to store and manage your favorite
A new favorite command can be added from
ranking or raw history view by pressing <kbd>Ctrl-f</kbd>.
You can check your favorite commands by choosing
favorite view - rotate views using <kbd>Ctrl-/</kbd> or start
`hh` by adding `favorites` to `HH_CONFIG` environment
property. A favorite command can be choosen just
by pressing `ENTER` when on command in favorite view.
Last chosen favorite commands appears as the first
one (at the top of the page) in the favorite view.
You can delete a favorite command with `DEL` key.
* Favorite commands are stored in `~/.hh_favorites`
* Suffix your favorite commands with comments
describing their purpose. For example
`printf "\e[?2004l" # fix terminal copy/paste`
Such comment can be used for normal commands
as well and may serve as a way how to **tag**
`hh` allows you to specify a set of commands to be
skipped from all the views. Blacklist typically contains
frequently used commands whose completion from history
has a little or no value. The default blacklist looks
* Blacklist of commands is stored in `~/.hh_blacklist`
If the file doesn't exist, you may create it and complete
it with your own blacklist.
* You can skip any command from history just by
prefixing it with `SPACE`. For example:
` echo "Skip this from history"` It's a Bash
option that is configured using
`HISTCONTROL=ignorespace` environment variable.
Using `hh` you can easily delete the last command from history
e.g. when you make a typo or write something sensitive:
See configuration section for how to bind this functionality to
a key - bound to <kbd>Ctrl+x k</kbd> by default.
Get more colors when running `hh`:
Start `hh` in configured view and filter out history items
Print history items containing 'git' to standard output and exit:
hh --non-interactive git
Append default `hh` configuration to your Bash profile:
hh --show-configuration >> ~/.bashrc
Check `hh` man page:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/hstr
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://email@example.com/user/xaizek/hstr
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
... clone the repository ...
... make some changes and some commits ...
git push origin master