4.9 KiB
Configuration
Get most of HSTR by configuring it with:
hh --show-configuration >> ~/.bashrc
Run hh --show-configuration to determine what will be appended to your Bash profile. Don't forget
to source ~/.bashrc to apply changes.
For more configuration options details please refer to:
- Bind
hhto a keyboard shortcut - Get more colors
- Choose default history view
- Set filtering preferences
- Configure commands blacklist
- Disable confirm on delete
- Tune verbosity
- Bash:
- zsh:
- zsh Emacs keymap (default)
- zsh history settings
Check also configuration examples.
Binding HSTR to Keyboard Shortcut
Bash uses Emacs style keyboard shortcuts by default. There is also Vi mode. Find out how to bind HSTR to a keyboard shortcut based on the style you prefer below.
Check your active Bash keymap with:
bind -v | grep editing-mode
bind -v | grep keymap
To determine character sequence emitted by a pressed key in terminal, type Ctrlv and then press the key. Check your current bindings using:
bind -S
Colors
Get hh in more colors:
export HH_CONFIG=hicolor
or ensure black and white mode:
export HH_CONFIG=monochromatic
History View
Show normal history by default (instead of metrics-based view):
export HH_CONFIG=rawhistory
Show favorite commands by default (instead of metrics-based view):
export HH_CONFIG=favorites
Filtering
Make search case sensitive (insensitive by default):
export HH_CONFIG=casesensitive
Keep duplicates in rawhistory view (duplicates discarded by default):
export HH_CONFIG=duplicates
Static favorites
Latest favorite command is put the head of favorite commands list by default. If you want to disable this behavior and make favorite commands list static, then use the following configuration:
export HH_CONFIG=static-favs
Blacklist
Skip commands when processing history i.e. make sure that these commands will not be shown in any view:
export HH_CONFIG=blacklist
Commands to be stored in ~/.hh_blacklist file with trailing empty line. For instance:
cd
my-private-command
ls
ll
Confirm on Delete
Do not prompt for confirmation when deleting history items:
export HH_CONFIG=noconfirm
Verbosity
Show a message when deleting the last command from history:
export HH_CONFIG=verbose-kill
Show warnings:
export HH_CONFIG=warning
Show debug messages:
export HH_CONFIG=debug
Bash Emacs Keymap (default)
Bind hh to a Bash key e.g. to Ctrlr:
bind '"\C-r": "\C-ahh -- \C-j"'
or CtrlAltr:
bind '"\e\C-r":"\C-ahh -- \C-j"'
or CtrlF12:
bind '"\e[24;5~":"\C-ahh -- \C-j"'
Bind hh to Ctrlr only if it is interactive shell:
if [[ $- =~ .*i.* ]]; then bind '"\C-r": "\C-a hh -- \C-j"'; fi
You can bind also other hh commands like -kill-last-command:
if [[ $- =~ .*i.* ]]; then bind '"\C-xk": "\C-a hh -k \C-j"'; fi
Bash Vim Keymap
Bind hh to a Bash key e.g. to Ctrlr:
bind '"\C-r": "\e0ihh -- \C-j"'
Bash History Settings
Use the following BASH settings to get most out of hh.
Increase the size of history maintained by BASH - variables defined below increase the number of history items and history file size (default value is 500):
export HISTFILESIZE=10000
export HISTSIZE=${HISTFILESIZE}
Ensure syncing (flushing and reloading) of .bash_history with in-memory
history:
export PROMPT_COMMAND="history -a; history -n; ${PROMPT_COMMAND}"
Force appending of in-memory history to .bash_history
(instead of overwriting):
shopt -s histappend
Use leading space to hide commands from history:
export HISTCONTROL=ignorespace
Suitable for a sensitive information like passwords.
Zsh Emacs Keymap (default)
Bind hh to a zsh key e.g. to Ctrlr:
bindkey -s "\C-r" "\eqhh --\n"
Zsh History Settings
If you use zsh, set HISTFILE environment variable in ~/.zshrc:
export HISTFILE=~/.zsh_history
Examples
More colors with case sensitive search of history:
export HH_CONFIG=hicolor,casesensitive
Favorite commands view in black and white:
export HH_CONFIG=favorites,monochromatic
Keywords based search in colors with debug mode verbosity:
export HH_CONFIG=keywords,hicolor,debug