📝 Edit your Zsh history from the command line.
MIT License
zsh-hist
Edit your Zsh history, without ever leaving the command line.
git clone
this repo.~/.zshrc
file:
source path/to/zsh-hist.plugin.zsh
To update, cd
into your clone and git pull
.
Whenever you finish your command line, zsh-hist
will automatically format it for you, before it is saved to history.
You can also retroactively format your history with hist n
.
unsetopt HIST_REDUCE_BLANKS
in your .zshrc
file. Otherwise, most of the indentation will get lost.;
s into newlines, declaring ;
as a global alias will most of the time simply not have any effect. Since this is.zshrc
file:
zstyle ':hist:*' auto-format no
zsh-hist
can automatically expand your aliases before each command line is saved to history. This is disabled by
default, but to enable it, add the following to your .zshrc
file:
zstyle ':hist:*' expand-aliases yes
On any new command line, you can now press Undo to pop the last command from your history into the line editor, letting you correct any mistakes you made, before running it back. Afterwards, the old, faulty command will be gone from your history and only the new, corrected one remains.
Additionally, if you make a typo and end up on the secondary prompt, you can now press Undo to return to the primary prompt.
When you press ⌃Q, your line is now written to history (without being executed) instead of to the buffer stack.
This has the following benefits:
Pressing ⌃Q on the secondary prompt will return you to the primary prompt.
hist
command syntaxUsage
hist [<option>...] compress <delta>
hist [<option>...] {reload|undo}
hist [<option>...] <command> <selection> ...
Return value
$reply an associative array of history index -> entry tuples
Options
-f force: never ask for confirmation
-i interactive: always ask for confirmation
-q quiet: do not print anything
-s silent: same as quiet
By default, hist asks for confirmation only when operating on multiple history
entries.
Commands (can be shortened to first letter):
compress delete each entry that differs <delta> chars or less from the next
delete remove from history
edit delete, then modify & append as new
fix delete + get
get load into buffer
list look, but do not touch
normalize delete, then auto-format & append as new
reload re-initialize local history from file
undo roll back to before last command in same session
Selections (for commands other than compress, reload or undo):
negative int offset from end of history
positive int index from beginning of history
pattern all matching entries
Examples
hist f -1 # Fix last entry (cut from history; paste into command line)
hist n {1..9} # Normalize (uniformly format) a range of history items
hist d $'*(\n|;)' # Delete all entries ending in newline or semicolon
© 2020 Marlon Richert
This project is licensed under the MIT License. See the LICENSE file for details.