How do I install zsh-hist on Zsh?

Clone the repository and add 'source path/to/zsh-hist.plugin.zsh' to your .zshrc file. Updates require git pull from the clone directory, as per the README.

Does zsh-hist work with Oh My Zsh?

It can be integrated as a custom plugin by sourcing it manually, but it's not natively supported by Oh My Zsh's plugin manager, so configuration might require extra steps.

How to undo a command with zsh-hist?

Press the Undo key on a new command line to pop the last history entry into the editor for correction. The old command is then replaced in history, as explained in the added functionality section.

zsh-hist vs histdb for Zsh history management?

zsh-hist focuses on in-line editing and formatting tools, while histdb offers SQLite-based history querying and search. Choose zsh-hist if you need direct editing, or histdb for advanced searching.

How to disable automatic formatting in zsh-hist?

Add 'zstyle ':hist:*' auto-format no' to your .zshrc file to turn off automatic code formatting, as specified in the README notes.

Can zsh-hist expand aliases in saved history?

Yes, but it's optional. Enable by adding 'zstyle ':hist:*' expand-aliases yes' to .zshrc, which expands aliases before commands are saved to history.

Open-Awesome

hist

MITShell

Edit and manage your Zsh command history directly from the terminal with automatic formatting and undo functionality.

GitHub

198 stars17 forks0 contributors

What is hist?

zsh-hist is a Zsh plugin that enables editing and management of Zsh shell history directly from the command line. It provides tools to format, edit, delete, and manipulate history entries without leaving the terminal, solving the problem of messy or incorrect command history.

Target Audience

Zsh users who want better control over their shell history, particularly developers and system administrators who work extensively in the terminal and want to maintain clean, formatted command histories.

Value Proposition

Developers choose zsh-hist because it integrates history management directly into their workflow with powerful editing commands, automatic formatting, and undo functionality—all without requiring external editors or tools.

Overview

📝 Edit your Zsh history from the command line.

Use Cases

Best For

Correcting mistakes in recently executed commands
Formatting shell history for better readability
Bulk editing or deleting history entries
Managing aliases in command history
Maintaining clean command history without external tools
Implementing undo functionality for terminal commands

Not Ideal For

Environments requiring immutable shell history for audit or compliance purposes
Users with complex global alias setups that rely on semicolons or other formatting-sensitive elements
Teams using shared Zsh configurations where disabling HIST_REDUCE_BLANKS might cause conflicts
Developers who prefer graphical or external history editors and don't mind context switching

Pros & Cons

Pros

Automatic History Formatting

Formats commands before they are saved to history, improving readability and consistency, as highlighted in the README's automatic code formatting section.

Integrated Editing Commands

Provides a comprehensive `hist` command with subcommands like edit, delete, and normalize, enabling history manipulation directly from the terminal without external tools.

Undo Functionality

Pressing Undo pops the last command into the line editor for correction, then replaces the faulty entry in history, enhancing error recovery as described.

Optional Alias Expansion

Can automatically expand aliases before commands are saved to history when enabled via zstyle, keeping history clean and alias-free.

Cons

Configuration Conflicts

Requires unsetting HIST_REDUCE_BLANKS in .zshrc for full formatting preservation, which may disrupt existing shell settings or history compression preferences.

Alias Interference

Automatic formatting can disable certain global aliases, such as those using semicolons, limiting advanced alias usage for power users.

Manual Installation

Lacks package manager support; installation involves cloning the repository and manually sourcing the plugin file, which can be cumbersome compared to integrated plugin systems.

Frequently Asked Questions

Related Projects

zoxide

A smarter cd command. Supports all major shells.

Stars38,203

Forks853

Last commit4 days ago

zsh-autosuggestions

Fish-like autosuggestions for zsh

Stars35,900

Forks1,937

Last commit1 year ago

zsh-syntax-highlighting

Fish shell like syntax highlighting for Zsh.

Stars22,878

Forks1,376

Last commit5 months ago

autojump

A cd command that learns - easily navigate directories from the command line

Stars16,952

Forks708