Skip to main content

​
Synopsis

hline [OPTIONS]

​
Description

hline is a centered-cursor TUI for browsing bash history. When you run hline, it loads your bash history file and presents it in an interactive terminal interface.

​
Options

​
--file
path
Path to a custom history file to browse.If not specified, hline uses the default bash history path:
  • $HOME/.bash_history when the HOME environment variable is set
  • ./.bash_history as a fallback
Example:
hline --file ~/.zsh_history
​
--help
flag
Display help information about available options and exit.Example:
hline --help
​
--version
flag
Display version information and exit.Example:
hline --version

​
Usage examples

​
Browse default bash history

hline
This loads ~/.bash_history and opens the interactive browser.

​
Browse a custom history file

hline --file /path/to/custom_history
You can point hline at any text file with one command per line.

​
Browse history from a different user

sudo hline --file /home/otheruser/.bash_history

​
Exit codes

The program returns standard exit codes:
  • 0 - Successful execution
  • Non-zero - An error occurred (e.g., history file not found, permission denied)

​
Interactive mode

Once hline launches, you can use keyboard shortcuts to navigate, search, and copy commands. See the keybindings page for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us