Oh My Zshでzsh-abbrをインストールする方法

updated@2026-03-12

公式ドキュメントのインストール手順にOh My Zshへの具体的な手順が載ってなかったので備忘録

インストール手順

まず以下のコマンドを実行して、GitHubからソースをcloneしてきます

> git clone --recurse-submodules https://github.com/olets/zsh-abbr.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-abbr

ここで--recurse-submodulesオプションを指定するのを忘れずに！
この指定が漏れていると、zsh起動時に「abbr: There was a problem finishing installing dependencies」というエラーが発生します

cloneが終わったら、.zshrcのpluginsにzsh-abbrを追加して再起動します

.zshrc

plugins=(
    ...
    zsh-abbr
)

最後に、実際に試してみます

> abbr c=clear
> c[Enter]
>
> abbr hg="history | grep"
> hg[space]clone

historyコマンドで履歴を確認してみて、cと打った時の履歴がclearとなっていること、
hg[space]を打った段階でターミナル上でhistory | grepと略語が展開されていることを確認できたら成功です

ちなみにabbr listコマンドで登録済みの略語一覧を確認できます

これにて完成