Installing Amazon Q for command line - Amazon Q Developer
Supported environmentsVerifyingUninstalling

Installing Amazon Q for command line

To install Amazon Q for command line, complete the following steps.

  1. Download Amazon Q for command line (macOS only)

  2. Authenticate with Builder ID, or with IAM Identity Center using the start URL given to you by your account administrator.

  3. Follow the instructions to install the shell integrations, and to grant macOS accessiblity permissions.

    Automated checks section showing Shell integrations checked and Enable accessibility unchecked.

Supported command line environments

Amazon Q for command line integrates with the following environments:

  • Operating systems: macOS

  • Shells: bash, zsh, fish

  • Terminal emulators: iTerm2, macOS terminal, Hyper, Alacritty, Kitty, wezTerm

  • IDEs: VS Code terminal, Jetbrains terminals (except Fleet)

  • CLIs: 500+ of the most popular CLIs such as git, aws, docker, npm, yarn

Verifying your download

After you download Amazon Q for command line, you can verify its code signature as follows:

codesign -v /Applications/Amazon\ Q.app

If there is no output, then the app's code signature is valid, and it has not been tampered with since it was signed.

For more verbose information about the app signature, run:

codesign -dv --verbose=4 /Applications/Amazon\ Q.app

To learn more about the macOS codesign utility, see the Code Signing Guide on the Apple developer website.

Uninstalling Amazon Q for command line

To uninstall Amazon Q for command line, complete the following steps.

  1. Open a terminal window.

  2. Run the following command:

    q uninstall