> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/iagctl/completion/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# iagctl completion

Generate shell completion scripts.

The `iagctl completion` command outputs completion code for `bash`, `zsh`, or `fish` to enable interactive command completion in your shell.

## Syntax

```bash
iagctl completion [bash|zsh|fish]
```

## Set up completion on macOS

If you're using Bash on macOS, you first need to install `bash-completion` using Homebrew. Run `bash --version` to check your version, then follow the steps for your version below.

#### Bash 3.2

1. Install bash-completion v1.x:

```bash
    brew install bash-completion
```

2. Enable bash-completion:

```bash
    echo 'source $(brew --prefix)/etc/bash_completion' >> ~/.bash_profile
```

3. Install the gateway completion script:

```bash
    iagctl completion bash > $(brew --prefix)/etc/bash_completion.d/iagctl
```

With Bash 3.2, you need to run this command every time you update the gateway or switch your application mode to ensure you have the latest completion available.

4. Reload your shell.

#### Bash 4.1+

1. Install bash-completion v2.x:

```bash
    brew install bash-completion@2
```

2. Enable bash-completion:

```bash
    echo 'brew_etc="$(brew --prefix)/etc" \
    && [[ -r "${brew_etc}/profile.d/bash_completion.sh" ]] \
    && . "${brew_etc}/profile.d/bash_completion.sh"' >> ~/.bash_profile
```

3. Install the gateway completion script:

```bash
    echo 'source <(iagctl completion bash)' >> ~/.bash_profile
```

4. Reload your shell.

## Set up completion on Linux

1. Install bash-completion using your package manager:

```bash
    # RHEL/CentOS
    yum install bash-completion

    # Debian/Ubuntu
    apt-get install bash-completion
```

2. Reload your shell and verify the installation:

```bash
    type _init_completion
```

If this command fails, run:

```bash
    echo 'source /usr/share/bash-completion/bash_completion' >> ~/.bashrc
```

3. Install the gateway completion script:

```bash
    echo 'source <(iagctl completion bash)' >> ~/.bashrc
```

4. Reload your shell.

## Set up completion for Zsh

1. Install the gateway completion script:

```bash
    echo 'source <(iagctl completion zsh)' >> ~/.zshrc
```

2. Reload your shell.

## Set up completion for Fish

1. Install the gateway completion script:

```bash
    echo 'iagctl completion fish | source' >> ~/.config/fish/config.fish
```

2. Reload your shell.

## Options

```bash
  -h, --help   Help for completion
```

## Options inherited from parent commands

```bash
  --profile string   Specify the client profile to use (case-insensitive, defaults to [client] section)
  --config string   Path to the configuration file
  --raw             Display the result of the command in raw format
  --verbose         Enable verbose output
```