Repolode
ajeetdsouza

ajeetdsouza/zoxide

よく使うディレクトリを学習し、主要なシェルから数回のキー入力で移動できる、賢いcdコマンド。

スター
40,192
フォーク
929
未解決の Issue
160
最終コミット
一昨日

これは何?

zoxideは、訪問したディレクトリを記録し、使用頻度と最近の利用状況に基づいて順位付けするcdコマンドの代替ツールです。たとえば「z foo」のように、zの後に名前の一部を入力すると、該当するディレクトリのうち最も順位の高いものに移動できるため、フルパスを入力する必要がほとんどありません。

Bash、Zsh、Fish、PowerShell、Nushell、Elvish、Xonsh、Tcsh、およびPOSIXシェルで動作します。crates.io、Homebrew、winget、Scoop、conda、多くのLinuxディストリビューションのリポジトリからインストールできます。fzfがインストールされていれば、ziコマンドで対話型セレクターを開けます。また、z、autojump、fasd、atuinなどのツールから履歴をインポートできます。

除外グロブ、データベースの保存場所、最大エントリー数など、マッチング動作やデータベースの経年処理は環境変数で設定できます。Rustで開発されており、MITライセンスで公開されています。

主な機能

  • 01ディレクトリの利用頻度と最近の利用状況に基づいて順位付けし、実際によく使う場所へ移動できます。
  • 02Bash、Zsh、Fish、PowerShell、Nushell、Elvish、Xonshなどのシェルで動作します。
  • 03ziコマンドとfzfを使った対話型選択に対応しています。
  • 04z、autojump、fasd、atuinなどのツールから履歴をインポートできます。
  • 05除外対象、データベースの保存場所、経年処理の上限を環境変数で設定できます。

ユースケース

  • フルパスを入力せずに、ターミナルからよく使うプロジェクトフォルダー間を移動する。
  • z、autojump、fasdから移行し、既存のディレクトリ履歴を引き継ぐ。
  • Windows PowerShell、Linux、macOSのシェルで共通のディレクトリ移動コマンドを使う。

クイックスタート

  1. 1

    インストールスクリプトでバイナリをインストールします

    README の公式手順に従ってインストール
  2. 2

    または、Cargo を使って crates.io からインストールします

    cargo install zoxide --locked
  3. 3

    Bash の設定ファイル(通常は ~/.bashrc)の末尾に zoxide を追加します

    eval "$(zoxide init bash)"
  4. 4

    シェルを再起動し、z でディレクトリに移動します

    z foo

使う前に知っておきたいこと

  • シェルの設定には、シェル設定ファイルを手動で編集する必要があります。
  • タブ補完とインタラクティブ選択(zi)を使うには、別途 fzf をインストールする必要があります。

トピック

よくある質問

zoxide とは?
よく使うディレクトリを学習し、主要なシェルから数回のキー入力で移動できる、賢いcdコマンド。 zoxideは、訪問したディレクトリを記録し、使用頻度と最近の利用状況に基づいて順位付けするcdコマンドの代替ツールです。たとえば「z foo」のように、zの後に名前の一部を入力すると、該当するディレクトリのうち最も順位の高いものに移動できるため、フルパスを入力する必要がほとんどありません。
zoxide は無料で使えますか?ライセンスは?
zoxide は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
zoxide は今もメンテナンスされていますか?
活発にメンテナンス中。zoxide の最終コミットは 2026年10月18日 です。
zoxide は何に使えますか?
フルパスを入力せずに、ターミナルからよく使うプロジェクトフォルダー間を移動する。 z、autojump、fasdから移行し、既存のディレクトリ履歴を引き継ぐ。 Windows PowerShell、Linux、macOSのシェルで共通のディレクトリ移動コマンドを使う。
zoxide のインストール方法は?
インストールスクリプトでバイナリをインストールします または、Cargo を使って crates.io からインストールします: cargo install zoxide --locked Bash の設定ファイル(通常は ~/.bashrc)の末尾に zoxide を追加します: eval "$(zoxide init bash)" シェルを再起動し、z でディレクトリに移動します: z foo
zoxide はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ajeetdsouza/zoxide

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト