====== 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.((https://github.com/aws/amazon-q-developer-cli|aws/amazon-q-developer-cli on GitHub))

GitHub: [[https://github.com/aws/amazon-q-developer-cli|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((https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html|Official Documentation))
  * **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:((https://github.com/aws/amazon-q-developer-cli|aws/amazon-q-developer-cli on GitHub))

  * **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 =====

<code bash>
# 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"
</code>

===== How It Works =====

<mermaid>
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]
</mermaid>

===== GitHub Actions Integration =====

Amazon Q integrates with GitHub Actions for automated workflows:((https://aws.amazon.com/q/developer/|AWS Product Page))

  * **/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 =====

  * [[gemini_cli|Gemini CLI]] — Google's terminal agent
  * [[cline|Cline]] — Model-agnostic autonomous coding agent
  * [[droid_factory|Droid (Factory)]] — Factory's multi-model CLI coding agent
  * [[trae_agent|Trae Agent]] — ByteDance's research-friendly CLI agent
  * [[devon|Devon]] — Open-source pair programmer

===== References =====