Fish Shell の abbr で使う。キミが好きだよ、エイリアス

はじめに

ターミナルで作業をしていると、同じコマンドを何度も入力することがありますよね。git checkout -b feature/new-branch や kubectl get pods --all-namespaces のような長いコマンドを毎回タイプするのは面倒です。

多くのシェルでは「エイリアス」を使ってこの問題を解決しますが、Fish Shell にはとても優れた機能があります。それが abbreviation（略して abbr） です。

生成AIやエージェントがコマンドライン操作を支援するようになった今、履歴(history)の可読性はこれまで以上に重要です。この記事では、なぜエイリアスと別れたのか、そして abbr が現代のターミナルワークに必須のツールである理由を詳しく解説します。

fishshell.com

abbr とは

abbr は、入力した短い文字列を長いコマンドに展開する機能です。たとえば gco と入力してスペースやエンターを押すと、自動的に git checkout に展開されます。

最大の特徴は、展開がリアルタイムで可視化されることです。エイリアスと違い、実際に実行されるコマンドを目で確認してから実行できます。

abbr の圧倒的なアドバンテージ

これが最も重要なポイントです。2024年以降、共同作業や自動化ツールに加え、生成AIがターミナルワークを下支えするようになりました。そして、abbr はこの新しいワークスタイルに完璧にフィットします。

履歴から作業内容が誰にでも伝わる

例えば、昨日の作業をチームに共有するときです。

エイリアスの場合:

$ history | tail -20
gco feature-branch
gaa
gcm "Add new feature"
gp origin feature-branch

履歴を受け取った人には何が起こったか全く分かりません。gco や gaa が何を意味するのかも相手には伝わりません。個人のローカル設定は共有されていないからです。

abbr の場合:

$ history | tail -20
git checkout feature-branch
git add --all
git commit -m "Add new feature"
git push origin feature-branch

誰が見ても即座に理解できます。ブランチを切り替え、全ての変更をステージングし、コミットしてプッシュしたのだとすぐ分かります。

実際の活用例

例1: デバッグ支援

# あなたのコマンド履歴（abbr を使用）
$ kubectl get pods --namespace production
$ kubectl logs pod-abc123 --namespace production
$ kubectl describe pod pod-abc123 --namespace production
$ kubectl get events --namespace production --sort-by='.lastTimestamp'

# 共有したい質問: "このエラーの原因を知りたい"

履歴を見た人はコンテキスト全体を理解して、適切な解決策を提示できます。エイリアス（例：k、kgp、kl）だと、何が起きているか推測すらできません。

例2: ワークフローの自動化

# 毎日のデプロイ作業（abbr で記録された履歴）
$ docker compose build
$ docker compose down
$ docker compose up -d
$ docker compose logs --tail=100 web
$ curl https://example.com/health

# 「この手順をスクリプト化して」と頼むだけ

誰でも履歴を見て、ほぼそのまま自動化スクリプトを組み立てられます。

例3: チームメンバーへの説明

# Slack や Issue に貼り付けるだけで伝わる
昨日のデプロイ手順:
$ git pull origin main
$ npm install
$ npm run build
$ docker compose build
$ docker compose up -d

エイリアスだと毎回「それは何のコマンドか」と説明が必要になりますが、abbr なら誰でも理解できます。

コマンド履歴が機械可読になる

現代の開発環境では、GitHub Copilot CLI、Claude Code、Cursor、Aider、Warp、Fig といった生成AIベースの支援ツールがあなたのコマンド履歴を解析します。

これらのツールは、実際のコマンド履歴を分析して次に実行するべきコマンドを提案します。またエラーの原因を特定して修正方法を示し、作業パターンを学習して効率化を促し、プロジェクトのワークフロー理解にもつながります。

エイリアスを使っていると、こうしたAIや人が作業内容を理解するのは困難です。abbr を使えば、履歴に記録されるのは実際のコマンドなので、コンテキストを正確に共有できます。

チーム開発での透明性

リモートペアプログラミングやスクリーンシェアで作業を共有する際です。

# あなた: この手順でデプロイします
$ dk build
$ dk up -d
$ dk logs -f

チームメイト: 「...何をしているのか分かりません」

abbr なら次のようになります。

$ docker compose build
$ docker compose up -d
$ docker compose logs -f

チームメイト: 「完璧に理解しました」

ドキュメントとしての履歴

あなたのコマンド履歴は、最高のドキュメントになります。例えば、kubectl でのデプロイ作業を考えてみましょう。

エイリアスの場合、履歴には k apply -f deployment.yaml、k get pods、k logs -f pod-name のように記録され、意味が分かりません。

abbr の場合は kubectl apply -f deployment.yaml、kubectl get pods、kubectl logs -f pod-name と記録されます。これなら、Wiki にコピペできますし、Issue にそのまま貼れます。解析ツールに渡して内容を振り返ってもらうこともでき、新しいチームメンバーの教材にもなります。

エイリアスの時代は終わった

はっきり言います。エイリアスは過去の遺物です。

エイリアスが作られた時代には、コマンド履歴を第三者が読むこともあまり想定されていませんでした。スクリーンシェアで作業を共有する機会も多くありませんでした。

しかし、2024年以降の開発環境は根本的に変わりました。コマンド履歴を解析する生成AIやエージェントが普及し、チームメンバーがリアルタイムであなたの画面を見ながら作業することも珍しくありません。履歴が検索可能なナレッジベースとして扱われるのが普通になりつつあります。

この新しい現実において、abbr は必須です。エイリアスを使い続けることは、こうしたメリットを自ら放棄しているのと同じです。

エイリアスとの決定的な違い

エイリアス（Alias）の場合

alias gco="git checkout"

コマンド履歴には gco と記録される
実際に何が実行されたか後から分からない
他人と共有する際に説明が必要

abbr の場合

abbr --add gco "git checkout"

スペースキーを押すと git checkout が即座に展開される
コマンド履歴には展開後の git checkout が記録される
履歴を検索する際に、エイリアスの短縮形ではなく実際のコマンドで検索できる
スクリーンショットやドキュメントにそのままコピペできる

abbr を使うべき理由

abbr の主なメリットは、コマンド履歴が検索しやすくなること、他者とコマンドを共有しやすくなること、そして実際に何が実行されるかが常に可視化されることです。

展開されたコマンドを毎回見るため、オプションを自然に覚えられる学習効果があります。history コマンドで過去のコマンドを見たとき、実際に何をしたかが一目瞭然です。同僚に「このコマンドを実行して」と伝える際、abbr で展開されたコマンドをそのまま共有できます。展開後に追加の引数を加えたり、一部を修正したりするのも簡単です。そして、abbr はインタラクティブシェルでのみ展開され、スクリプト内では展開されません。

基本的な使い方

abbr を追加する

abbr --add gst "git status"
abbr --add gaa "git add --all"
abbr --add gcm "git commit -m"

または、短縮形で表現できます。

abbr -a gst "git status"
abbr -a gaa "git add --all"
abbr -a gcm "git commit -m"

登録されている abbr を確認する

abbr --list
# または
abbr -l

abbr を削除する

abbr --erase gst
# または
abbr -e gst

すべての abbr を表示する

abbr --show
# または
abbr -s

実践的な abbr 設定例

私の実際の config.fish から、カテゴリ別に便利な abbr を紹介します。

ナビゲーション系

# ディレクトリ移動を快適に
abbr --add --global -- - 'cd -'           # 直前のディレクトリに戻る
abbr --add --global .. 'cd ..'            # 一つ上の階層へ
abbr --add --global ... 'cd ../..'        # 二つ上の階層へ
abbr --add --global .... 'cd ../../..'    # 三つ上の階層へ

Git 系（最も使用頻度が高い）

abbr --add --global g git
abbr --add --global ga 'git add'
abbr --add --global gaa 'git add --all'
abbr --add --global gc 'git commit -v'
abbr --add --global gcm 'git commit -m'
abbr --add --global gco 'git checkout'
abbr --add --global gcb 'git checkout -b'
abbr --add --global gp 'git push'
abbr --add --global gpl 'git pull'
abbr --add --global gst 'git status'
abbr --add --global gd 'git diff'
abbr --add --global gl 'git log'
abbr --add --global gf 'git commit --amend --no-edit'  # 直前のコミットを修正

Docker 系

abbr --add --global d docker
abbr --add --global dc 'docker compose'
abbr --add --global dcu 'docker compose up'
abbr --add --global dcd 'docker compose down'
abbr --add --global dps 'docker ps'

Kubernetes 系

abbr --add --global k kubectl
abbr --add --global kgp 'kubectl get pods'
abbr --add --global kgs 'kubectl get svc'
abbr --add --global kgd 'kubectl get deploy'

エディタ系

abbr --add --global v nvim
abbr --add --global vim nvim

高度な abbr の使い方

1. `--global` オプション

abbr --add --global gst "git status"

--global スコープで定義すると、universal スコープ（デフォルト）よりもわずかに高速です。config.fish で定義する場合は --global を使用するのがベストプラクティスです。

2. `--position anywhere` - どこでも展開

デフォルトでは、abbr はコマンドの位置（行頭）でのみ展開されますが、--position anywhere を使うとパイプの後などでも展開できます。

abbr -a L --position anywhere --set-cursor "% | less"

3. `--set-cursor` - カーソル位置の指定

展開後のカーソル位置を指定できます。% がカーソル位置のマーカーです。

abbr --add grepf --set-cursor 'grep -r "%" . | fzf'

grepf とタイプしてスペースを押すと grep -r "" . | fzf に展開され、カーソルが "" の中に配置されます。

4. `--regex` - 正規表現によるマッチング

パターンを正規表現で指定できます。たとえば、.txt で終わるファイル名を vim で開けます。

function vim_edit
    echo vim $argv
end

abbr -a vim_edit_texts --position command --regex ".+\.txt" --function vim_edit

5. `--function` - 関数による動的展開

関数を使って動的にコマンドを生成できます。bash の !! に相当する機能です。

function last_history_item
    echo $history[1]
end

abbr -a !! --position anywhere --function last_history_item

6. `--command` - 特定コマンドでのみ展開（Fish 4.0+）

Fish 4.0 以降では、特定のコマンドに対してのみ展開される abbreviation を作成できます。

abbr --add --command git co checkout

この場合、git co は git checkout に展開されますが、co 単独では展開されません。

config.fish への設定方法

abbr は一度設定すれば記憶されますが、dotfiles として管理する場合は config.fish に記述する必要があります。

推奨される設定方法

if status is-interactive
    # 既存の abbr をクリーンアップ（エラーを無視）
    abbr --erase gst 2>/dev/null
    abbr --erase gaa 2>/dev/null
    
    # 新しく abbr を追加
    abbr --add --global gst 'git status'
    abbr --add --global gaa 'git add --all'
    # ... 他の abbr
end

if status is-interactive で囲むことで、インタラクティブシェルでのみ abbr が定義されます。

`--erase` してから `--add` する理由

config.fish は新しいシェルを起動するたびに実行されます。既存の abbr を消してから追加することで、変更が確実に反映されます。

私の設定では、すべての abbr をまとめて消去してから再定義しています。

if status is-interactive
    # 既存のabbreviationをクリーンアップ（エラーを無視）
    abbr --erase -- - 2>/dev/null
    abbr --erase .. 2>/dev/null
    abbr --erase ... 2>/dev/null
    # ... すべての abbr を列挙
    
    # ナビゲーション
    abbr --add --global -- - 'cd -'
    abbr --add --global .. 'cd ..'
    # ... 新しく定義
end

よくある質問

abbr とエイリアスはどちらを使うべきか

A: abbr を使ってください。議論の余地はありません。エイリアスは裏で展開されるため、実際に何が実行されているかが分かりにくくなります。特に生成AIや外部の支援ツールやチームメンバーと履歴を共有するのが当たり前になった今では、abbr は必須です。

ただし、複雑な処理（条件分岐やパイプの組み合わせなど）が必要な場合は、関数を使いましょう。

abbr はスクリプトで使えるか

A: いいえ。abbr はインタラクティブシェルでのみ展開され、スクリプト内では展開されません。スクリプトでは関数やエイリアスを使ってください。

スペースキーを押さずに abbr を展開したくない場合

A: Ctrl+Space を押すと、abbr を展開せずにスペースを入力できます。

abbr を一時的に無効にしたいとき

A: abbr は一度定義されると永続化されるので、完全に削除するか、新しいセッションでは config.fish の該当行をコメントアウトしてください。

Fish 以外のシェルでも abbr を使う方法

「Fish に興味はあるけど、Zsh や Bash から移行するのは大変...」と感じる人も多いでしょう。

朗報です。abbr の恩恵は他のシェルでも受けられます。

Zsh で abbr を使う

Zsh には zsh-abbr という優れたプラグインがあります。Fish の abbr に完全にインスパイアされており、ほぼ同じ機能を提供します。他にも追加でいくつか類似ソフトウェアがあるので自分にあうものを選んでほしいです。

インストール方法

Homebrew を使う場合:

brew install olets/tap/zsh-abbr

手動インストールの場合:

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

.zshrc に次の設定を追加します。

# プラグインとして読み込む
plugins=(... zsh-abbr)

使い方

# abbr を追加
abbr gco="git checkout"
abbr gst="git status"

# グローバル abbr（コマンド位置以外でも展開）
abbr -g L="| less"

# 一覧表示
abbr list

# 削除
abbr erase gco

Fish とほぼ同じシンタックスで使えます。

github.com

手動で実装する方法（軽量版）

プラグインを使いたくない場合は、以下のコードを .zshrc に追加するだけで基本的な abbr 機能が使えます。

# 展開可能なエイリアスのリスト
typeset -a ealiases
ealiases=()

# abbr 風のエイリアス作成関数
function abbrev-alias() {
    alias $1
    ealiases+=(${1%%\=*})
}

# スペースキーでエイリアスを展開
function expand-ealias() {
    if [[ $LBUFFER =~ "\<(${(j:|:)ealiases})\$" ]]; then
        zle _expand_alias
        zle expand-word
    fi
    zle magic-space
}
zle -N expand-ealias

# スペースキーをバインド
bindkey ' ' expand-ealias
bindkey '^ ' magic-space  # Ctrl+Space で展開をスキップ

# Enter キーでも展開
expand-alias-and-accept-line() {
    expand-ealias
    zle .backward-delete-char
    zle .accept-line
}
zle -N accept-line expand-alias-and-accept-line

# abbr を定義
abbrev-alias gco="git checkout"
abbrev-alias gst="git status"
abbrev-alias gcm="git commit -m"

dev.to

Bash で abbr 風の機能を実装する

Bash には組み込みの abbr 機能はありませんが、bind コマンドを使って似たような動作を実現できます。

# スペースキーで展開される「abbr」を実装
bind '"\e[0n": " "'

# abbr のような関数
function abbr-expand() {
    local cmd="${READLINE_LINE%% *}"
    case "$cmd" in
        gco) READLINE_LINE="git checkout${READLINE_LINE#gco}" ;;
        gst) READLINE_LINE="git status${READLINE_LINE#gst}" ;;
        gcm) READLINE_LINE="git commit -m${READLINE_LINE#gcm}" ;;
    esac
}

# Space キーにバインド
bind -x '"\e[0n": abbr-expand'

ただし、Bash での実装は Zsh や Fish ほど洗練されていないため、本格的に abbr を使いたい場合は Zsh + zsh-abbr または Fish への移行 をお勧めします。

どのシェルを選ぶべきか

abbr を最大限活用したいなら、Fish がネイティブサポートで最高の体験を提供します。Zsh + zsh-abbr は Fish とほぼ同等で、POSIX 互換性も維持できます。Bash は限定的なサポートなので、他の選択肢がない場合のみお勧めします。

特に、共同作業や自動化が標準になった今では、abbr のようなトランスペアレントな機能が必須です。どのシェルを使うにしても、エイリアスから abbr への移行を強くお勧めします。

よくある質問（追加）

今使っている Zsh から Fish に移行すべきか

A: abbr だけが目的なら、zsh-abbr プラグインで十分です。ただし、Fish は他にも多くの優れた機能（シンタックスハイライト、自動補完など）を持っているので、試してみる価値はあります。

既存のエイリアスを abbr に移行するのは大変か

A: 非常に簡単です。alias を abbr に置き換えるだけです。Fish の場合は abbr --add、Zsh の zsh-abbr の場合も abbr コマンドがそのまま使えます。

まとめ

Fish Shell の abbr は、単なるショートカット以上の価値があります。変化の激しい開発環境において、abbr は必須のツールです。

abbr が提供する価値

abbr は誰にとっても読みやすい履歴を残し、あとから状況を把握する人があなたの作業を完璧に理解できるようにします。実際のコマンドが常に見えることで可視性が確保され、コマンドを自然に覚えられる学習効果があります。チームメンバーとのコミュニケーションが円滑になり、意味のある機械可読な履歴が残ります。生成AIエージェントに渡したときにも正確なコンテキストが伝わり、展開後の編集も柔軟で、コマンド履歴がそのまま最高のドキュメントになります。

エイリアスから abbr への移行

今すぐ始めるべき理由は明確です。Claude Code、Codex、Copilot CLI、Cursor などの支援ツールがあなたの作業を理解できるようになります。チーム開発の透明性が高まり、リモートワークやペアプログラミングでの生産性も劇的に向上します。加えて、コマンド履歴が検索可能で再利用できるナレッジとして蓄積されます。

移行は非常に簡単です。Fish を使っているなら abbr --add で定義するだけ。Zsh なら zsh-abbr プラグインをインストールするだけです。

エイリアスの時代はおそらく終わる気がしています。それでもエイリアスのおかげで多くの時間を節約できたのは事実ですし、長く愛用してきた相棒でもあります。ありがとう、エイリアス。

参考リンク