Skip to main content

​
Quick install

The fastest way to install hline is using the installation script: 
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | bash
This downloads the latest release from GitHub and installs it to ~/.local/bin/hline.

​
Installation options

​
Install a specific version

To install a specific version instead of the latest: 
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | \
  bash -s -- --version v0.1.0

​
Customize installation directory

By default, hline installs to ~/.local/bin. You can change this with the --bin-dir option: 
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | \
  bash -s -- --bin-dir /usr/local/bin

​
All installation options

The install script supports these options:
  • --repo OWNER/REPO - Install from a different GitHub repository
  • --version vX.Y.Z - Install a specific version (default: latest)
  • --bin-dir PATH - Installation directory (default: ~/.local/bin)
  • --help - Show help message
You can combine multiple options. For example:
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | \
  bash -s -- --version v0.1.0 --bin-dir ~/.local/bin

​
Build from source

If you prefer to build from source, you’ll need Rust 1.78 or later.
1

Clone the repository

git clone https://github.com/PedroElizalde01/hline.git
cd hline
2

Build the release binary

cargo build --release
The binary will be at ./target/release/hline.
3

Install the binary

install -m 0755 ./target/release/hline ~/.local/bin/hline
For development builds and testing, see the Building from source guide.

​
Verify installation

After installation, verify that hline is working: 
hline --version
You should see output like: 
hline 0.1.0
Check available options: 
hline --help
This shows: 
Browse bash history in a centered-cursor TUI

Usage: hline [OPTIONS]

Options:
      --file <PATH>  
  -h, --help         Print help
  -V, --version      Print version

​
Troubleshooting

​
Command not found

If you get hline: command not found, the installation directory is not in your PATH.
1

Check where hline was installed

The default location is ~/.local/bin/hline. Verify it exists:
ls -la ~/.local/bin/hline
2

Add the directory to your PATH

Add this line to your shell profile (~/.bashrc, ~/.bash_profile, or ~/.profile):
export PATH="$HOME/.local/bin:$PATH"
3

Reload your shell configuration

source ~/.bashrc
Or start a new terminal session.

​
Permission denied

If you get a permission error when running the install script with --bin-dir /usr/local/bin, you need elevated privileges: 
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | \
  sudo bash -s -- --bin-dir /usr/local/bin
Only use sudo when installing to system directories like /usr/local/bin. For personal use, ~/.local/bin is recommended.

​
Checksum verification failed

If the installation fails with a checksum mismatch error, the download may have been corrupted. Try running the install command again: 
curl -fsSL https://raw.githubusercontent.com/PedroElizalde01/hline/main/install.sh | bash
If the problem persists, install a specific version using --version.

Build docs developers (and LLMs) love

Get started for freeTalk to us