Skip to content

Latest commit

 

History

History
112 lines (75 loc) · 1.8 KB

File metadata and controls

112 lines (75 loc) · 1.8 KB

git-als

A Zsh plugin to list and manage Git aliases in a grouped, sorted, and filterable way.


Preview

Preview


Features

  • Lists all Git aliases in your configuration.
  • Smart Grouping:
    • First command word (for normal aliases)
    • Alias name prefix (for function aliases !f() {...})
    • First Git subcommand (for !git ... aliases)
    • “Other” for remaining bang commands
  • Filtering: Supports filtering by keyword(s) with AND matching.
  • Highlighting: Highlights matched keywords in yellow.
  • Clean Output: Shortens function aliases in output for readability (!f()).
  • Compatibility: Fully compatible with Oh My Zsh, Zinit, Znap.

Installation

Oh My Zsh

  1. Clone the repository into your custom plugins folder:
git clone https://github.com/evcli/git-als.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/git-als
  1. Add git-als to your plugin list in .zshrc:
plugins=(... git-als)
  1. Reload your shell:
source ~/.zshrc

Zinit

zinit light evcli/git-als

Manual

  1. Clone the repo:
git clone https://github.com/evcli/git-als.git ~/path/to/git-als
  1. Source it in your .zshrc:
source ~/path/to/git-als/git-als.plugin.zsh

Usage

After installation, the main command is:

git-als [keywords...]

or using the alias:

gals [keywords...]

Examples

  • List all Git aliases:

    gals
  • Filter aliases containing "log":

    gals log
  • Filter aliases containing both "commit" and "push":

    gals commit push

Contributing

Feel free to submit issues or pull requests. Please keep commits clean and update documentation when adding new features.


License

MIT License