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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant