Release Summary
Compose Hot Reload 1.2.0 is here 🎉.
This release introduces a Model Context Protocol (MCP) server that enables AI agents to interact with a running Compose application in real time.
Highlights
- 🤖 New MCP server for AI agent integration
- ☕ JBR 25 by default, with a configurable minimum version
- 🧯 Richer error reporting in the dev tools
MCP Server
The new hot-reload-mcp module exposes a Model Context Protocol server through the hotMcpServer Gradle task. The server connects to a running Compose app, waits for startup, detects shutdowns, and reconnects automatically. Any MCP-compatible AI agent can use it to inspect and control the application:
| Tool | Description |
|---|---|
status
| View app and reload state, including details of the last error |
reload / await_reload
| Trigger a hot reload and wait for it to complete |
restart / reset_ui
| Restart the app or reset its running UI |
take_screenshot
| Capture a screenshot, optionally saving it to a specified path |
list_windows / resize_window
| Inspect and resize application windows |
get_semantic_tree
| Read the semantic tree, including Dialog, ModalBottomSheet, and Popup elements
|
get_ui_error / get_logs
| Read the current UI error and application logs |
click, type_text, scroll, …
| Simulate user interactions |
Dev Tools
- Reload failures now include detailed error information, shown in the notification overlay with the Copy and Copy path to file actions.
- Multi-window support: fixed the hot reload panel becoming non-interactive in multi-window mode.
JBR & Gradle
- The default runtime is now JBR 25. Use the
compose.reload.jbr.min.versionproperty to configure the minimum supported JBR version. - Unsafe incremental compilation is now disabled by default for multiplatform projects. Opt in with
compose.reload.gradle.build.optimize.unsafe=true.
Thanks to everyone who filed issues, tested pre-releases, and contributed to this release 🙏