LazyHis

A simple terminal UI for shell history, written in Go!

Why LazyHis?

LazyHis focuses on simplicity, speed, and a clean terminal UI.

• 🚀 Fast: Written in Go for maximum performance.
• 🎨 Customizable: Supports themes and keybindings.
• 🔍 Powerful: Advanced filtering, customizable, and shell integration.

Table of contents

• Quick Install
  • Homebrew
  • Build from Source
  • Configure zsh
• Feature Roadmap
• Customization
• Alternatives

Quick Install

1. Install the lazyhis binary:

With Homebrew (Recommended)

brew tap nobbmaestro/homebrew-tap
brew install lazyhis

Build from Source

git clone git@github.com:nobbmaestro/lazyhis.git
cd lazyhis
make install

2. Add the init script to your shell's config file:

Zsh

Add the following to the end of ~/.zshrc:

# ~/.zshrc

eval "$(lazyhis init zsh)"

3. Import existing histfile:

Zsh

lazyhis history import --zsh /path/to/histfile

Feature Roadmap

• Add export CLI command for exporting to HISTFILE
• Add generate shell-completions CLI command
• Add prune CLI command for removing history based on ignore pattern
• Add dry flag for prune CLI command
• Add verbosity flag for prune and import CLI commands
• Copy to clipboard via GUI
• Customizable GUI theme
• Customizable command exclusion by patterns
• Customizable command exclusion by prefix
• Customizable keybindings
• Delete history entries via GUI
• Delete multiple history entries via GUI
• Edit history entries via GUI
• Filter history by context via GUI
• Fuzzy-finder search strategy in GUI
• Support for inline GUI mode

Customization

Check out the configuration docs.

Alternatives

If lazyhis isn't quite what you're looking for, you might prefer:

• Atuin