# Shell 自動補全

如果你已**全域安裝** Tuist（例如透過 Homebrew），你可以為 Bash 和 Zsh 安裝 Shell 自動補全，以自動完成指令與選項。

> [!WARNING]
> **什麼是全域安裝**
>
> 全域安裝是指安裝位置包含在你的 Shell `$PATH` 環境變數中。這表示你可以在終端機的任何目錄執行 `tuist`。這是 Homebrew 的預設安裝方式。


#### Zsh {#zsh}

如果你已安裝 [oh-my-zsh](https://ohmyz.sh/)，你已經擁有一個會自動載入補全腳本的目錄 — `.oh-my-zsh/completions`。將新的補全腳本複製到該目錄中名為 `_tuist` 的新檔案：

```bash
tuist --generate-completion-script > ~/.oh-my-zsh/completions/_tuist
```

若沒有 `oh-my-zsh`，你需要將補全腳本的路徑加入函式路徑，並啟用補全腳本的自動載入。首先，將以下幾行加入 `~/.zshrc`：

```bash
fpath=(~/.zsh/completion $fpath)
autoload -U compinit
compinit
```

接著，在 `~/.zsh/completion` 建立一個目錄，並將補全腳本複製到該新目錄中，同樣命名為 `_tuist`。

```bash
tuist --generate-completion-script > ~/.zsh/completion/_tuist
```

#### Bash {#bash}

如果你已安裝 [bash-completion](https://github.com/scop/bash-completion)，你可以直接將新的補全腳本複製到檔案 `/usr/local/etc/bash_completion.d/_tuist`：

```bash
tuist --generate-completion-script > /usr/local/etc/bash_completion.d/_tuist
```

若沒有 bash-completion，你需要直接 source 補全腳本。將其複製到例如 `~/.bash_completions/` 的目錄，然後將以下這行加入 `~/.bash_profile` 或 `~/.bashrc`：

```bash
source ~/.bash_completions/example.bash
```

#### Fish {#fish}

如果你使用 [fish shell](https://fishshell.com)，你可以將新的補全腳本複製到 `~/.config/fish/completions/tuist.fish`：

```bash
mkdir -p ~/.config/fish/completions
tuist --generate-completion-script > ~/.config/fish/completions/tuist.fish
```