Neon Deploy: Learn how Neon helps developers ship faster with Postgres. Grab your ticket
Docs/CLI Reference/completion

Neon CLI commands — completion

Use the Neon CLI to manage Neon directly from the terminal

Before you begin

Before running the completion command, ensure that you have installed the Neon CLI.

The completion command

This command generates a completion script for the neonctl command-line interface (CLI). The completion script, when installed, helps you type neon commands faster and more accurately. It does this by presenting the possible commands and options when you press the tab key after typing or partially typing a command or option.

Usage

neon completion

The command outputs a completion script similar to the one shown below.

important

Use the completion script that is output to your terminal or command window, as the script may differ depending on your operating environment.

###-begin-neonctl-completions-###
#
# yargs command completion script
#
# Installation: neonctl completion >> ~/.bashrc
#    or neonctl completion >> ~/.bash_profile on OSX.
#
_neonctl_yargs_completions()
{
    local cur_word args type_list

    cur_word="${COMP_WORDS[COMP_CWORD]}"
    args=("${COMP_WORDS[@]}")

    # ask yargs to generate completions.
    type_list=$(neonctl --get-yargs-completions "${args[@]}")

    COMPREPLY=( $(compgen -W "${type_list}" -- ${cur_word}) )

    # if no match was found, fall back to filename completion
    if [ ${#COMPREPLY[@]} -eq 0 ]; then
      COMPREPLY=()
    fi

    return 0
}
complete -o bashdefault -o default -F _neonctl_yargs_completions neonctl
###-end-neonctl-completions-###

Use the commands provided below to add the completion script to your shell configuration file, which is typically found in your home directory. Your shell configuration file may differ by platform. For example, on Ubuntu, you should have a .bashrc file, and on macOS, you might have bash_profile or .zshrc file. The source command causes the changes to take effect immediately in the current shell session.

neon completion >> ~/.bashrc
source ~/.bashrc

Need help?

Join our Discord Server to ask questions or see what others are doing with Neon. Users on paid plans can open a support ticket from the console. For more detail, see Getting Support.

Last updated on

Was this page helpful?