Last updated June 16, 2023

Heroku CLI Autocomplete helps you complete command and flag names when you press the tab key. CLI Autocomplete completes all commands in the Heroku CLI and automatically supports new commands as they’re added. You can also complete values for some flags and args, including apps, pipelines and config vars.

Installing Autocomplete

To get started, update your CLI and run the setup.

$ heroku update
$ heroku autocomplete

The specific instructions that you receive depend on whether you use bash or zsh. After you finish setup, Autocomplete is ready to use with the tab key.

This feature is only available for bash and zsh.

Command Name Completion

You can start writing a command and then press tab to see the different possibilities for completing it. You can match against all commands that match a given prefix.

$ heroku <TAB>
addons              -- lists your add-ons and attachments
addons:attach       -- attach add-on resource to a new app
addons:create       -- create an add-on resource
...

For example, pressing tab after typing heroku add autocompletes to heroku addons.

Flag Name Completion

Most CLI commands use flags to provide additional input. Flags are prefaced with two dashes (--), such as (--app). Some commands have many different possible flags. You can view all available flags for each command by typing -- and then pressing the tab key. You can match against all flag names that match a given prefix.

$ heroku apps:info --<TAB>
--app               -- (autocomplete) app to run command against
--as                -- name for add-on attachment

For example, pressing tab after typing heroku apps:info --a autocompletes to heroku apps:info --app.

Flag Value Completion

Most flags require you to provide a value. For example, --app requires you to specify the name of an app. With Autocomplete, you can complete values for many popular flags, including --app,--pipeline, --space, and --team.

$ heroku apps:info --app=<TAB>
staging-app
production-app

For example, you have the two apps listed in the output above and you press tab after typing:

heroku apps:info --app=p

It autocompletes to:

heroku apps:info --app=production-app

Not all flags have autocomplete options. Flags that have these options are tagged with (autocomplete) during flag name autocompletion. For an example, see Completing flag names.

Completion for Config Vars and Add-On Names

You can complete config vars and add-on names when the CLI knows the app. The CLI can infer the app via the Git remote, or you can provide the app name via a flag. We call these kinds of completions contextual completions because the CLI needs context to know how to complete them.

Uninstalling Autocomplete

To uninstall Autocomplete, remove the plugin and delete the autocomplete environment variable from your zsh or bash profile.

$ heroku plugins:uninstall autocomplete