ohmyzsh/plugins/aliases/README.md
Codebuff Contributor 358568dd32 fix(per-directory-history): save to both history files and only push stack in directory mode
The addhistory hook previously had two bugs when inc_append_history
or share_history was not set:

1. Commands were only saved to one history file (HISTFILE or per-dir)
   depending on when fc -AI was called, resulting in lost history.

2. fc -p was called unconditionally after every command, corrupting
   the zsh history stack even in global mode. This caused the per-dir
   hook to push a new history frame on every command, breaking the
   global history state.

Fix: always write both history files via fc -AI before any mode
check, and only call fc -p (to push into per-directory history)
when actually in directory mode.

Signed-off-by: god032396-del <god032396@gmail.com>
2026-06-13 02:21:31 +00:00

792 B

Aliases cheatsheet

With lots of 3rd-party amazing aliases installed, this plugin helps list the shortcuts that are currently available based on the plugins you have enabled.

To use it, add aliases to the plugins array in your zshrc file:

plugins=(aliases)

Requirements: Python needs to be installed.

Maintainer: @hqingyi

Usage

  • als: show all aliases by group

  • als -h/--help: print help message

  • als <keyword(s)>: filter and highlight aliases by <keyword>

  • als -g <group>/--group <group>: show only aliases for group <group>. Multiple uses of the flag show all groups

  • als --groups: show only group names

    screenshot