hstr/man/hh.1

.TH HH 1
.SH NAME
\fBhh\fR \- shell history suggest box
.SH SYNOPSIS
.B hh [option] [arg1] [arg2]...
.SH DESCRIPTION
.B hh
uses shell history to provide suggest box like functionality
for commands used in the past. By default it parses .bash-history
file that is filtered as you type a command substring. Commands 
are not just filtered, but also ordered by a ranking algorithm
that considers number of occurences, length and timestamp. In addition
hh allows removal of commands from history - for instance with a typo or with a sensitive content.
.SH OPTIONS
.TP 
\fB--show-configuration\fR
Show configuration that can be added to .bashrc
.TP 
\fB--help\fR
Show help
.SH COMMANDS
.TP 
\fBpattern\fR
Type to filter shell history.
.TP 
\fBCtrl\-t\fR
Toggle case sensitive search.
.TP 
\fBCtrl\-/\fR
Toggle history as provided by shell vs. ranked history ordered by the number of occurences, length and timestamp.
.TP 
\fBCtrl\-l\fR
Make search pattern lowercase or uppercase.	
.TP
\fBCtrl\-r\fR, \fBUP\fR arrow, \fBDOWN\fR arrow
Navigate in the history list. 
.TP
\fBTAB\fR, \fBLEFT\fR arrow, \fBRIGHT\fR arrow,
Choose currently selected item for completion and let user to edit it on the command prompt.
.TP
\fBENTER\fR
Choose currently selected item for completion and execute it.
.TP 
\fBDEL\fR
Remove currently selected item from the shell history.
.TP
\fBBACSKSPACE\fR, \fBCtrl\-h\fR
Delete last pattern character.
.TP
\fBCtrl\-u\fR, \fBCtrl\-w\fR
Delete pattern and search again.
.TP
\fBCtrl\-x\fR
Write changes to shell history and exit.
.TP
\fBCtrl\-g\fR
Exit with empty prompt.
.SH ENVIRONMENT VARIABLES
\fBhh\fR defines the following environment variable:
.TP
\fBHH_CONFIG\fR
Configuration options:

\fIhicolor\fR 
        Get more colors with this option (default is monochromatic).

\fIcasesensitive\fR
        Make the pattern-based filtering case sensitive by default. 

\fIrawhistory\fR
        Show normal history by default (default is metric-based). 

Example:
        \fBexport HH_CONFIG=casesensitive,hicolor\fR

.SH CONFIGURATION
Optionally add the following lines to ~/.bashrc:
.nf
.sp
export HH_CONFIG=hicolor         # get more colors
shopt -s histappend              # append new history items to .bash_history
export HISTCONTROL=ignorespace   # leading space hides commands from history
export HISTFILESIZE=10000        # increase history file size (default is 500)
export HISTSIZE=${HISTFILESIZE}  # increase history size (default is 500)
export PROMPT_COMMAND="history \-a; history \-n; ${PROMPT_COMMAND}"
bind '"\eC\-r": "\eC\-a hh \eC-j"'    # bind hh to Ctrl-r
.sp
.fi
The prompt command ensures synchronization of the history between BASH memory 
and history file.
.SH AUTHOR
Written by Martin Dvorak <martin.dvorak@mindforger.com>
.SH BUGS
Report bugs to https://github.com/dvorka/hstr/issues
.SH "SEE ALSO"
.BR history (1),
.BR bash (1)