Skip to content

Commit 7eabe83

Browse files
committed
New install guide for Amazon Q CLI
1 parent 34a9c84 commit 7eabe83

File tree

2 files changed

+136
-0
lines changed

2 files changed

+136
-0
lines changed
460 KB
Loading
Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
---
2+
title: Amazon Q Developer CLI
3+
author: Jason Andrews
4+
minutes_to_complete: 10
5+
official_docs: https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line.html
6+
7+
test_maintenance: true
8+
test_images:
9+
- ubuntu:latest
10+
11+
layout: installtoolsall
12+
multi_install: false
13+
multitool_install_part: false
14+
tool_install: true
15+
weight: 1
16+
---
17+
18+
Amazon Q Developer for the command line is a CLI tool for Amazon Q, a generative artificial intelligence (AI) powered assistant. You can use it to ask questions about AWS architecture and resources in addition to general developer tasks.
19+
20+
It is available for a variety of operating systems and Linux distributions, supports the Arm architecture, and has multiple ways to install it.
21+
22+
## What should I do before installing Amazon Q Developer CLI?
23+
24+
You need a Builder ID to use the Amazon Q Developer CLI. If you don't have one, visit [Do more with AWS Builder ID](https://community.aws/builderid) and use the Sign up button to create your Builder ID.
25+
26+
This guide explains how to install the latest version of the Amazon Q Developer CLI on computers running Arm Linux and macOS.
27+
28+
## How do I download and install Amazon Q Developer CLI?
29+
30+
The CLI is invoked with the `q` command, and you can install it on macOS and Arm Linux.
31+
32+
### How do I install the Q CLI on macOS?
33+
34+
Install [Homebrew](https://brew.sh/) if it is not already available on your computer.
35+
36+
Install the Q CLI:
37+
38+
```console
39+
brew install amazon-q
40+
```
41+
42+
### How do I install the Q CLI on Arm Linux?
43+
44+
The easiest way to install the latest version of the Q CLI for any Arm Linux distribution is to download and run the installer.
45+
46+
Before starting, make sure `curl` and `unzip` are available on your computer.
47+
48+
The commands for Debian-based distributions such as Ubuntu are below. For other Linux distributions use the package manager to install `curl` and `unzip`.
49+
50+
```bash { target="ubuntu:latest" }
51+
sudo apt update
52+
sudo apt install curl unzip -y
53+
```
54+
55+
Download the zip file with `curl`, extract the installer, and run it.
56+
57+
```bash { target="ubuntu:latest" }
58+
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux.zip" -o "q.zip"
59+
unzip q.zip
60+
bash ./q/install.sh
61+
```
62+
63+
Answer the question about updating your shell config.
64+
65+
```output
66+
✔ Do you want q to modify your shell config (you will have to manually do this otherwise)?
67+
```
68+
69+
{{% notice Note %}}
70+
If you have a Linux distribution with an older version of the GNU C Library or one which does not use the GNU C Library such as Alpine Linux, you can download an alternative package which uses the musl C library and has no external dependencies.
71+
72+
Substitute the `curl` command above with this one and use the same install instructions:
73+
74+
```console
75+
curl "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux-musl.zip" -o "q.zip"
76+
```
77+
78+
{{% /notice %}}
79+
80+
### How do I confirm the Q CLI is working?
81+
82+
You now have the latest version of the Amazon Q Developer CLI installed.
83+
84+
Confirm the CLI is available by invoking the `q` command to print the version.
85+
86+
```bash { target="ubuntu:latest" }
87+
q version
88+
```
89+
90+
The version is printed:
91+
92+
```output
93+
q 1.7.2
94+
```
95+
96+
## How can I configure my AWS account to get the most from the Q CLI?
97+
98+
The Q CLI can answer questions and solve problems related to your AWS resources and help you develop faster on AWS. To get the maximum benefit, you can configure the AWS CLI to use your account.
99+
100+
Follow the [AWS CLI install guide](/install-guides/aws_access_keys/) and the [AWS Credentials install guide](/install-guides/aws_access_keys/) to set up the AWS CLI and generate and configure access keys.
101+
102+
This allows you to use the Amazon Q Developer CLI to ask questions and solve issues specific to your AWS account.
103+
104+
## What is an example of using the Q CLI?
105+
106+
You can use `q chat` to find information about your AWS resources.
107+
108+
```console
109+
q chat
110+
```
111+
112+
When the chat session starts you see:
113+
114+
```output
115+
Hi, I'm Amazon Q. Ask me anything.
116+
117+
Things to try
118+
• Fix the build failures in this project.
119+
• List my s3 buckets in us-west-2.
120+
• Write unit tests for my application.
121+
• Help me understand my git status
122+
123+
/acceptall Toggles acceptance prompting for the session.
124+
/profile (Beta) Manage profiles for the chat session
125+
/context (Beta) Manage context files for a profile
126+
/help Show the help dialogue
127+
/quit Quit the application
128+
```
129+
130+
For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it.
131+
132+
An example is shown below:
133+
134+
![Connect #center](/install-guides/_images/q.gif)
135+
136+
You are ready to use the Q CLI.

0 commit comments

Comments
 (0)