1. Docs
  2. Pulumi ESC CLI
  3. Command-line completion

Pulumi CLI command-line completion

    The Pulumi ESC CLI also has a command to generate a command-line completion script for Bash, Zsh, and Fish. This gives you tab completion for all commands, sub-commands, and flags, which can make it easier to remember what to type and where.

    Bash

    To use this, you’ll first need to ensure bash completion is installed:

    • On most current Linux distros, bash completion should be available.
    • On a Mac, install with brew install bash-completion.

    The esc completion bash command self-generates its own CLI script. You can save the output to a file.

    • On Linux, save to esc completion bash > /etc/bash_completion.d/esc.
    • On macOS, save to esc completion bash > /usr/local/etc/bash_completion.d/esc.

    Ensure that bash completion is run when you launch a new terminal by adding it to ~/.bash_profile.

    On Linux:

    if [ -f /etc/bash_completion ]; then
        . /etc/bash_completion
    fi
    

    On macOS:

    if [ -f /usr/local/etc/bash_completion ]; then
        . /usr/local/etc/bash_completion
    fi
    

    Finally, after saving the esc bash completion script, either reopen your terminal or source your profile in order to reload the bash completion scripts in your current terminal session (. ~/.bash_profile).

    Zsh

    The esc completion zsh command self-generates its own CLI script. You can save the output to a file inside a directory listed in the $fpath variable.

    You can list your $fpath directories and pick one of them:

    echo $fpath
    

    You can also use an arbitrary directory like ~/.zsh/completion/ and then add it to your fpath in ~/.zshrc :

    fpath=(~/.zsh/completion $fpath)
    

    Make sure compinit is loaded or do it by adding in ~/.zshrc:

    autoload -Uz compinit && compinit -i
    

    Then reload your shell:

    exec $SHELL -l
    

    Fish

    The esc completion fish command self-generates its own CLI script. You can save the output to a file or use it in the current session:

    esc completion fish | source
    

    To load the completions for each session, you need to save the completion to a file:

    esc completion fish > ~/.config/fish/completions/esc.fish
    

    Finally, after saving the esc fish completion script, you need to reopen your terminal for the scripts to take effect.

      Introducing Pulumi Copilot - Intelligent Cloud Management