Amazon Q CLI
Amazon Q CLI is AWS's open-source agentic terminal experience for building applications, debugging issues, and managing DevOps workflows using natural language. Written in Rust for performance and reliability, it integrates deeply with AWS services while remaining useful for general development tasks. The project has nearly 2,000 GitHub stars and is licensed under Apache 2.0.1)
GitHub: aws/amazon-q-developer-cli
Key Features
Natural Language Chat — q chat provides an interactive AI assistant directly in the terminal
Agentic Execution — Autonomously plans and executes multi-step development tasks
AWS Integration — Deep integration with AWS services for cloud development, deployment, and debugging
2)
Git Workflow Automation — Streamlines commits, creates issues, automates code reviews and PR workflows
Subagent Architecture — Main agent delegates to specialized subagents for different task types
Code Generation — Generates code, applications, and infrastructure configurations from descriptions
MCP Support — Model Context Protocol integration for extending capabilities with external tools
Shell Completions — Intelligent tab completions for 500+ CLI tools including AWS CLI, git, docker, and npm
Adjustable Autonomy — Configurable permission levels from manual approval to full autonomy
Architecture
Amazon Q CLI is built in Rust (99.6% of codebase) for performance:3)
Chat Engine — Interactive q chat interface with streaming responses and tool execution
Agent Framework — Task decomposition with subagent delegation for specialized workflows
Tool System — File operations, shell execution, AWS
API calls, and MCP bridges
Auth Layer — AWS Builder ID and IAM Identity Center authentication
Completion Engine — Context-aware shell completions for hundreds of CLI tools
GitHub Integration — GitHub Actions workflows for automated issue-to-PR pipelines
Usage Example
# Install Amazon Q CLI
# macOS
brew install amazon-q
# Start interactive chat
q chat
# Build an application with natural language
q chat "Build a serverless REST API with Lambda and DynamoDB"
# Debug an issue
q chat "Why is my CloudFormation stack failing to deploy?"
# Automate a Git workflow
q chat "Create a GitHub issue for the authentication bug and draft a fix"
# Use slash commands
/issue "Add rate limiting to the API gateway"
How It Works
graph TD
A[Natural Language Input] --> B[Amazon Q Chat Engine]
B --> C[Task Analysis]
C --> D{Task Type}
D --> E[Code Generation Subagent]
D --> F[Debug Subagent]
D --> G[DevOps Subagent]
D --> H[Git Workflow Subagent]
E --> I[Generate Code/Config]
F --> J[Analyze Errors & Logs]
G --> K[AWS Service Operations]
H --> L[Issue/PR Management]
I --> M[File Operations]
J --> M
K --> N[AWS API Calls]
L --> O[GitHub API Calls]
M --> P[User Review]
N --> P
O --> P
P --> Q{Approved?}
Q -->|Yes| R[Execute Changes]
Q -->|No| S[Revise Approach]
S --> C
R --> T[Output Summary]
GitHub Actions Integration
Amazon Q integrates with GitHub Actions for automated workflows:4)
/q dev — Implements features or fixes from issue descriptions, creates PRs automatically
/q review — Performs AI-powered code review on pull requests
/q triage — Analyzes and labels new issues with appropriate tags and priority
See Also
-
Cline — Model-agnostic autonomous coding agent
-
Trae Agent — ByteDance's research-friendly CLI agent
Devon — Open-source pair programmer
References