Skip to content

Conversation

@harleylrn
Copy link
Contributor

@harleylrn harleylrn commented Aug 22, 2025

Title:

feat: complete amazon-q module v2.0.0 with comprehensive enhancements

Description:

This PR introduces a complete rewrite and enhancement of the amazon-q module, bringing it to version 2.0.0 with comprehensive functionality for Amazon Q integration in Coder workspaces. The module now provides full CLI installation, MCP integration for task reporting, AgentAPI support, and extensive customization options.

Type of Change

  • New module
  • Bug fix
  • Feature/enhancement
  • Documentation
  • Other

Module Information

Path: registry/coder/modules/amazon-q
New version: v2.0.0
Breaking change: [x] Yes [ ] No

Key Features & Enhancements

🚀 Core Functionality

  • AgentAPI Support: Web and CLI app integration with health checks
  • Amazon Q CLI Integration: Automatic installation and configuration of Amazon Q CLI
  • MCP Integration: Model Context Protocol support for task reporting to Coder
  • Authentication System: Tarball-based authentication with environment variable management

🛠️ Customization & Configuration

  • Pre/Post Install Scripts: Support for custom setup and finalization scripts
  • Agent Configuration: Templated agent config with tool and resource management
  • Custom System Prompts: Configurable AI behavior and task reporting instructions
  • Version Pinning: Support for specific Amazon Q CLI and AgentAPI versions

📚 Documentation & Testing

  • Comprehensive README: Complete user guide with examples, configuration details, and troubleshooting
  • Visual Documentation: Updated screenshots and interface examples
  • Terraform Testing: Complete .tftest.hcl with 8 test cases (all passing)
  • Registry Compliance: Full adherence to Coder Registry contributing guidelines

d## Breaking Changes

This is a major version update (v2.0.0) with breaking changes:

  • Renamed variables names (Removed experimantal_ prefix)
  • Updated AgentAPI integration method
  • Modified default configuration structure

Testing & Validation

  • Tests pass (terraform test - 8/8 tests passing)
  • Code formatted (bun run fmt)
  • Changes tested locally
  • Registry compliance verified
  • Documentation reviewed and updated

Related Issue

Additional Notes

  • Module is now production-ready with professional quality code and documentation
  • Full compliance with Coder Registry contributing guidelines
  • Comprehensive test coverage ensures reliability
  • Ready for registry submission and community use

Screenshots:

image image image
- Add complete Amazon Q CLI integration with automatic installation - Implement MCP (Model Context Protocol) integration for task reporting - Add AgentAPI support for web and CLI app integration - Support pre/post install scripts for custom setup and finalization - Add comprehensive authentication via tarball-based auth system - Include configurable AI prompts and custom system prompts - Add agent configuration templates with tool and resource management - Implement comprehensive .tftest.hcl with 8 test cases (all passing) - Create detailed README with examples, configuration guides, and troubleshooting - Add default agent configuration and system prompt documentation - Support version pinning for both Amazon Q CLI and AgentAPI - Include environment variable management for MCP integration - Add comprehensive error handling and validation - Support custom working directories and UI configuration - Implement clean variable management with unused variable removal - Add template file support for agent configuration - Include comprehensive documentation with visual examples - Support all major Amazon Q features and customization options - Full compliance with Coder Registry contributing guidelines - Production-ready module with professional quality code and documentation
@harleylrn harleylrn closed this Aug 22, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant