Amazon Q Developer: The AI-Powered Code Companion You’ve Been Waiting For

Alejandro Lazaro - Dec 17 - - Dev Community

I have published this article first on my blog here.

For months, I tried different generative AI tools in my IDE, but none felt AWS-oriented or fully integrated. I tested five other generative AI tools in my IDE, but none felt truly AWS-oriented or integrated, until now.

In this post, I’ll show you how Amazon Q can enhance your productivity, from chatting about code and inline suggestions to advanced code transformations and automated test generation. I’ll also tackle the big question: what happens to your code when using a generative AI service like this? And yes, I’ll show you actual examples using one of my own public GitHub repositories, appsync-website-mutation, so you can see how effortless it is to get started.

Introduction

This post focuses on Amazon Q Developer, but first, let me provide some context.

Amazon Q one year ago

Amazon Q was announced one year ago, at re:Invent 2023 (last week of November 2023), as an AI-powered assistant designed to help developers and IT professionals build, deploy, and manage applications and workloads on AWS.

While its potential was evident, my initial experience left me feeling that it was released prematurely. It felt incomplete and not yet suitable for daily workflows. It seemed like AWS had rushed to join the generative AI race, and the tool wasn’t quite ready to deliver on its promise.

Now, one year later, at re:Invent 2024 (first week of December 2024), AWS presented Amazon Q renewed and ready to be used. I’ve tested it, and now I can confidently say it’s now a valuable addition to any developer’s toolkit. This is the main reason for this post.

Amazon Q: Amazon Q Developer + Amazon Q Business

Built on Amazon Bedrock and leveraging 17 years of AWS expertise, Amazon Q encompasses both Amazon Q Developer for software development tasks and Amazon Q Business for enhancing enterprise productivity. It draws from AWS documentation, best practices, and real-world examples, making it a reliable and comprehensive AI assistant.

Amazon Q Developer

  • Specifically designed for software developers
  • Focuses on coding and development tasks
  • Key features include:
    • Code chat and assistance
    • Inline code completions
    • New code generation
    • Security vulnerability scanning
    • Code upgrades and improvements
    • Debugging and optimization suggestions
    • AWS architecture and resource guidance
  • Available through IDEs and development environments

Amazon Q Business

  • Designed for enterprise use across organizations
  • Focuses on business operations and productivity
  • Key features include:
    • Provides answers based on enterprise data
    • Content summarization
    • Document analysis
    • Task automation
    • Custom application creation (Q Apps)
    • Integration with business tools (40+ integrations)
    • Connectivity to data sources like SharePoint, S3, and Salesforce
  • Includes security features like:
    • Role-based access control
    • Data privacy controls
    • Content filtering
    • Integration with existing security permissions

The main differences

  • Purpose: Amazon Q Developer focuses on development tasks, while Amazon Q Business is designed for enterprise productivity.
  • Target Users: Developers and technical teams for Q Developer vs. business employees across various departments for Q Business.
  • Data Sources: Q Developer uses code and AWS documentation, while Q Business leverages enterprise data and documents.

Amazon Q Developer: Generative AI in Your IDE

On April 30, 2024, Amazon CodeWhisperer became part of Amazon Q Developer, bringing its generative AI-powered inline code suggestions, security vulnerability scanning, and remediation into the new platform. At re:Invent 2024, Amazon Q Developer introduced an expanded feature set, transforming it into much more than just a suggestion tool. It now helps you generate unit tests, review code for best practices, and even produce documentation on demand. This evolution makes Amazon Q Developer feel like a real AI partner, rather than just an autocomplete tool.

Where You Can Use Amazon Q Developer

Amazon Q Developer is available across several environments, making it easy to integrate into your workflow:

Generative AI at Your Fingertips

When integrated with your IDE, Amazon Q Developer acts as a powerful assistant, offering real-time development guidance. With its chat-based interface and slash commands, you can interact directly with the model to request suggestions or commands in plain English. Whether you need guidance on a new feature or help refactoring and improving your code, it's just a command away.

DISCLAIMER! Amazon Q Developer is not only about code. You can ask questions about AWS architecture, your AWS resources, best practices, documentation, support, and more. Here you have the full list of features of Amazon Q Developer.

Is it really free?

Amazon Q Developer offers two plans:

  • Amazon Q Developer Free Tier: Free (with limits)
  • Amazon Q Developer Pro Tier: $19/month per user

Important: In the Free Tier, when you reach 50 interactions in the IDE, you will receive the following notification:

limit

More information: Pricing and plan comparative

What Happens With Your Code?

A common concern is whether Amazon Q Developer uses your private code for model training or sharing. Here’s what you need to know:

  • Free Tier: Unless you opt out, your content may be used for model enhancement. You can opt out by following the instructions in the documentation.
  • Pro Tier: Your content is not used for service improvement or to train foundation models.

AWS also clarifies in the documentation:

Amazon Q stores your questions, its responses, and additional context, such as console metadata and code in your IDE, to generate responses to your questions. Your code is also stored for features like code transformation and software development in the IDE. This data is stored for up to 90 days to provide the service, and then is permanently deleted.

How to Opt Out

If you're using the Free Tier and prefer not to share your content, you can opt out easily. Here’s how:

opt-out-1
opt-out-2

The important one is this "Amazon Q: Share Content". More information

Hands-on with Amazon Q Developer

Before getting started, if you haven't installed the plugin in your IDE yet, follow this guide.

Then, you have to access to the plugin of AWS / Amazon Q, and you can start writing or just type /:

option slash

1. Chatting About Code or Something Else (AWS-related)

You can use the chat with Amazon Q in the IDE to ask any AWS-related question. I will had some concerns about Amazon Q sharing my data, so I will ask to Amazon Q directly instead of retrieve it from the documentation (as I did for the previous section):

![q-question(https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lklfh7lg86k0goedrum5.jpg)
q-response

As you can see, you can simply open the AWS Amazon Q chat extension and type your question directly.

2. Generating Inline Suggestions

As you type, Q Developer suggests completions right in your editor. For instance, if you're writing Terraform code and need to add a new DynamoDB table, Amazon Q can suggest completions:

resource "aws_dynamodb_table" "feedback" {
  name         = var.dynamodb_table_name
  billing_mode = "PAY_PER_REQUEST"
  hash_key     = "userId"
  range_key    = "notificationId"

  a
}
Enter fullscreen mode Exit fullscreen mode

Before you finish typing, Q Developer suggests the next part of the code, helping you code faster without breaking your flow.

inline-suggestions

3. Generate documentation (/doc)

/doc to task Amazon Q with writing API, technical design, and onboarding documentation.

In my project, I wanted to generate a README file based on my code. To do this, I typed:

/doc
Enter fullscreen mode Exit fullscreen mode

To open Q-Doc window. And there you don't have to type anything else, just select the options:

docs-1
docs-2

Of course, you can customize the message and ask for customized instructions.

However, I have found a few limitations in this /doc feature:

  • If your workspace contains multiple projects,
    • selecting the correct one can be unintuitive
    • if you select a different project than the first one, the README might still be generated in the first project folder
  • If you have a workspace with more than one project:
    • the selection of the project can be improved (is not very user-friendly)
    • if you select one project different to the first one, the content is created in the first project in one folder. This is wrong but I am sure they will fix it.
  • This feature only will create README files and only in the root of the project. What about if I want to create the README of only a part of a project? You can do it with custom instructions, but the file will be created in the root folder.
  • The markdown generated doesn’t completely follow the linting styles (markdownlint).

4. Developing Features (/dev)

/dev to task Amazon Q with generating new code across your entire project and implement features.

You can use the /dev to refactor current code:

refactor 1
refactor 2
refactor 3

5. Generating Unit Tests (/test)

/test to ask Amazon Q to generate unit tests and add them to your project, helping you improve code quality, fast.

Tired of writing boilerplate unit tests? Just highlight a function or class and run:

/test create the unit test for main.ts file
Enter fullscreen mode Exit fullscreen mode

test

Now, only Java and Python are supported, as you can view in the image. If you try to generate unit tests for other languages, Amazon Q will likely provide suggestions in the chat instead of generating actual test files. It will fall back to providing guidance rather than generating the actual test code.

6. Reviewing Code (/review)

/review to ask Amazon Q to perform code reviews, flagging suspicious code patterns and assessing deployment risk.

Need a second pair of eyes? Q Developer can review your code and highlight potential issues, security concerns, or performance bottlenecks. After highlighting a section and type:

/review
Enter fullscreen mode Exit fullscreen mode

You get back actionable suggestions: maybe you’re missing error handling, or you’re not using pagination for large DynamoDB queries. It’s like having a senior engineer at your side 24/7.

review

7. Transforming Code (/transform)

/transform to upgrade your Java applications in minutes, not weeks.

My code is not a Java code so I can't show you this feature but you can try yourself.

8. Select code and right-click

You have another option. You can just select the code you want, right-click and then you can select one of the options:

right-click

Conclusions

Amazon Q Developer feels like the next generation of coding assistance, purpose-built for AWS developers. With chat-based guidance, inline suggestions, powerful transformations, automated test generation, code review capabilities, and easy documentation, it streamlines many of the mundane coding tasks that eat away at our productivity.

That being said, if you plan to rely on Amazon Q Developer extensively, the Free Tier may not be sufficient due to its interaction limits. If you find yourself needing more, the Pro Tier offers additional features and a higher usage limit.

If you’ve been thinking about using a generative AI coding assistant for your AWS projects, Amazon Q Developer might be the tool that makes everything click. After trying it out in some personal repositories and seeing the immediate gains in speed and quality, I can say this is one AWS tool you don’t want to overlook.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .