README.md

LazyHis

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

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 [email protected]:nobbmaestro/lazyhis.git
cd lazyhis
make

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 doctor CLI command for verifying configuration
• 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 selected 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