You can install Amazon Q for command line for macOS by initiating a file download for the Amazon Q application. For more information, see Supported command line environments .
There are two modalities to consider when installing Amazon Q for command line. Minimal installation only distributes the binaries needed on Linux for Amazon Q chat and for the autocomplete feature to function over SSH (q
and qterm
). Full distribution contains the desktop application and requires the autocomplete feature to be used. If you want to only use the Amazon Q chat, consider that the minimal distribution also ships and installs qterm
to your shell. You can use qterm
for zsh to support inline completions and a full version isn't required. For more information, see Installing with a zip file .
For information about using the Amazon Q CLI with Windows, see this blog post on dev.to.
macOSYou can install Amazon Q for command line for macOS by downloading the application or by using Homebrew.
After installing Amazon Q for command line for macOS, you can enable SSH integration to be able to use autocomplete for over 500 command line tools. For more information, see Local macOS Integration .
To install Amazon Q for command line for macOS
(Optional) Verify the downloaded file for Amazon Q for command line on macOS. For more information, see To verify the download (optional).
Double-click on the downloaded .dmg file, and drag the app into your applications folder.
In your applications folder, double-click on Amazon Q. The GUI will open.
Enable the shell integrations. This will allow you to run Amazon Q from the shell, and will also allow Amazon Q to help you with shell command auto-completions.
Authenticate with Builder ID, or with IAM Identity Center using the start URL given to you by your account administrator.
Follow the instructions to install the shell integrations, and to grant macOS accessibility permissions.
You can install Amazon Q for command line for Linux using the AppImage format, which is a portable format that works on most Linux distributions without requiring installation.
To install Amazon Q for command line for Linux using AppImage
UbuntuYou can install Amazon Q for command line for Ubuntu using the .deb package.
To install Amazon Q for command line for Ubuntu
HomebrewTo install Amazon Q Developer CLI with Homebrew
brew install --cask amazon-q
Uninstalling Amazon Q for command line
You can uninstall Amazon Q for command line if you no longer need it.
To uninstall Amazon Q for command line on macOS
Open the Applications folder in Finder.
Locate the Amazon Q application.
Drag the application to the Trash, or right-click and select "Move to Trash".
Empty the Trash to complete the uninstallation.
To uninstall Amazon Q for command line on Ubuntu
Use the apt package manager to remove the package:
sudo apt-get remove amazon-q
Remove any remaining configuration files:
sudo apt-get purge amazon-q
If you're having a problem with Amazon Q Developer for command line, run q doctor
to identify and fix common issues.
$ q doctor
â Everything looks good!
Amazon Q still not working? Run q issue to let us know!
If your output doesn't look like the expected output, follow the prompts to resolve your issue. If it's still not working, use q issue
to report the bug.
Here are some common issues you might encounter when using Amazon Q for command line:
If you're having trouble authenticating, try running q login
to re-authenticate.
Ensure your shell integration is properly installed by running q doctor
.
Verify that your SSH server is properly configured to accept the required environment variables.
Follow these steps to troubleshoot issues with Amazon Q for command line:
Run q doctor
to identify and fix common issues.
Check your internet connection.
Verify that you're using a supported environment. For more information, see Supported command line environments .
Try reinstalling Amazon Q for command line.
If the issue persists, report it using q issue
.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4