2026.03.17 (#108)

Author: handstandsam

.github/workflows/build-desktop.yml

@@ -44,28 +44,22 @@ jobs:
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
 
-      - name: Build Shrunk Uber JAR
+      - name: Build Desktop JAR
         run: ./gradlew :trailblaze-desktop:shrinkUberJar -Ptrailblaze.proguard=true
 
-      - name: Upload Shrunk JAR Artifact
+      - name: Upload Desktop JAR
         uses: actions/upload-artifact@v4
         with:
           name: trailblaze-desktop-jar
           path: trailblaze-desktop/build/compose/jars-shrunk/trailblaze.jar
           if-no-files-found: error
           retention-days: 30
 
-      - name: Upload Full Uber JAR Artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: trailblaze-desktop-uber-jar
-          path: trailblaze-desktop/build/compose/jars/*.jar
-          if-no-files-found: error
-          retention-days: 30
-
       - name: Create GitHub Release
         if: startsWith(github.ref, 'refs/tags/v')
         uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2
         with:
-          files: trailblaze-desktop/build/compose/jars-shrunk/trailblaze.jar
+          files: |
+            trailblaze-desktop/build/compose/jars-shrunk/trailblaze.jar
+            scripts/trailblaze
           generate_release_notes: true

.mcp.json

@@ -85,6 +85,8 @@ subprojects
     it.afterEvaluate {
       if (it.plugins.hasPlugin("com.vanniktech.maven.publish.base")) {
         it.extensions.getByType(MavenPublishBaseExtension::class.java).also { publishing ->
+          publishing.publishToMavenCentral()
+          publishing.signAllPublications()
           publishing.pom {
             url.set("https://www.github.com/block/trailblaze")
             name = "trailblaze"

build.gradle.kts

@@ -86,6 +86,7 @@ Start the MCP server
 
 ```
 trailblaze mcp [OPTIONS]
+trailblaze mcp install
 ```
 
 **Options:**
@@ -100,6 +101,32 @@ trailblaze mcp [OPTIONS]
 
 ---
 
+### `trailblaze mcp install`
+
+Install MCP configuration for AI coding tools
+
+**Synopsis:**
+
+```
+trailblaze mcp install [OPTIONS] [<<target>>]
+```
+
+**Arguments:**
+
+| Argument | Description | Required |
+|----------|-------------|----------|
+| `<<target>>` | Target tool: claude, cursor, goose (omit to install all) | No |
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--port` | MCP endpoint port (default: 52525) | - |
+| `-h`, `--help` | Show this help message and exit. | - |
+| `-V`, `--version` | Print version information and exit. | - |
+
+---
+
 ### `trailblaze list-devices`
 
 List all connected devices

docs/CLI.md

@@ -480,7 +480,7 @@ Trailblaze implements innovations from [Mobile-Agent-v3](https://arxiv.org/abs/2
 | **BlazeGoalPlanner** | `BlazeGoalPlanner.kt` | Orchestrates all nodes |
 | **MultiAgentV3Runner** | `MultiAgentV3Runner.kt` | High-level entry point |
 
-See the [Mobile-Agent-v3 Integration Plan](decisions/032b_mobile_agent_v3_integration.md) for detailed usage.
+See the [Mobile-Agent-v3 paper](https://arxiv.org/abs/2508.15144) for background on this architecture.
 
 ## Future Considerations
 

docs/architecture.md

@@ -11,7 +11,6 @@
 - [objectiveStatus](functions/custom/objectiveStatus.md)
 - [openUrl](functions/custom/openUrl.md)
 - [pasteClipboard](functions/custom/pasteClipboard.md)
-- [pressBack](functions/custom/pressBack.md)
 - [pressKey](functions/custom/pressKey.md)
 - [requestViewHierarchyDetails](functions/custom/requestViewHierarchyDetails.md)
 - [scrollUntilTextIsVisible](functions/custom/scrollUntilTextIsVisible.md)
@@ -36,7 +35,6 @@
 - [objectiveStatus](functions/custom/objectiveStatus.md)
 - [openUrl](functions/custom/openUrl.md)
 - [pasteClipboard](functions/custom/pasteClipboard.md)
-- [pressBack](functions/custom/pressBack.md)
 - [pressKey](functions/custom/pressKey.md)
 - [requestViewHierarchyDetails](functions/custom/requestViewHierarchyDetails.md)
 - [scrollUntilTextIsVisible](functions/custom/scrollUntilTextIsVisible.md)

docs/generated/TOOLS.md

@@ -104,7 +104,7 @@ $THIS_DOC_IS_GENERATED_MESSAGE
     }
 
     private fun createFunctionsIndexPage(toolSets: Set<TrailblazeToolSet>) {
-        val map = toolSets.associate { it.name to it.toolClasses.map { it.toolName().toolName }.toSet() }
+        val map = toolSets.associate { it.name to it.toolClasses.filter { it.toKoogToolDescriptor() != null }.map { it.toolName().toolName }.toSet() }
 
         File(generatedDir, "TOOLS.md").also { file ->
             val text = buildString {

docs/generator/src/main/java/xyz/block/trailblaze/docs/DocsGenerator.kt

@@ -15,29 +15,29 @@ This allows leveraging existing execution environments and reporting systems, pr
 AI-driven tests at scale.
 
 Because Trailblaze uses [Maestro](https://github.com/mobile-dev-inc/maestro) Command Models for UI interactions it
-enables a [Longer Term Vision](#Longer-Term-Vision) of cross-platform ui testing while reusing the same authoring, agent
+enables a [Longer Term Vision](roadmap.md#longer-term-vision) of cross-platform ui testing while reusing the same authoring, agent
 and reporting capabilities.
 
 ### Core Features
 
 - **AI-Powered Testing**: More resilient tests using natural language test steps
 - **On-Device Execution**: Runs directly on Android devices using standard instrumentation tests (Espresso, UiAutomator)
-- **[Custom Agent Tools](#Custom-Tools)**: Extend functionality by providing app-specific `TrailblazeTool`s to the agent
-- **[Detailed Reporting](#Log-Server)**: Comprehensive test execution reports
+- **[Custom Agent Tools](architecture.md#custom-tools)**: Extend functionality by providing app-specific `TrailblazeTool`s to the agent
+- **[Detailed Reporting](logging.md)**: Comprehensive test execution reports
 - **Maestro Integration**: Uses a custom on-device driver for Maestro to leverage intuitive, platform-agnostic UI interactions
 
 ### Multi-Agent V3 Features
 
 Trailblaze implements cutting-edge features from [Mobile-Agent-v3](https://arxiv.org/abs/2508.15144) research:
 
-- **[Exception Handling](mobile-agent-v3-features.md#phase-1-exception-handling)**: Automatically handles popups, ads, loading states, and errors
-- **[Reflection & Self-Correction](mobile-agent-v3-features.md#phase-2-reflection--self-correction)**: Detects stuck states and loops, backtracks when needed
-- **[Task Decomposition](mobile-agent-v3-features.md#phase-3-task-decomposition)**: Breaks complex objectives into manageable subtasks
-- **[Cross-App Memory](mobile-agent-v3-features.md#phase-4-cross-app-memory)**: Remembers information across app switches for complex workflows
-- **[Enhanced Recording](mobile-agent-v3-features.md#phase-5-enhanced-recording)**: Captures pre/post conditions for more robust replay
-- **[Progress Reporting](mobile-agent-v3-features.md#phase-6-progress-reporting)**: Real-time MCP progress events for IDE integrations
+- **Exception Handling**: Automatically handles popups, ads, loading states, and errors
+- **Reflection & Self-Correction**: Detects stuck states and loops, backtracks when needed
+- **Task Decomposition**: Breaks complex objectives into manageable subtasks
+- **Cross-App Memory**: Remembers information across app switches for complex workflows
+- **Enhanced Recording**: Captures pre/post conditions for more robust replay
+- **Progress Reporting**: Real-time MCP progress events for IDE integrations
 
-See the [Mobile-Agent-v3 Features Guide](mobile-agent-v3-features.md) for detailed usage examples and configuration.
+See the [Architecture](architecture.md#multi-agent-v3-architecture) page for details.
 
 ## License
 

docs/index.md

@@ -176,29 +176,72 @@ Trails are saved as `.trail.yaml` files in the `trails/` directory:
 ### Running the Server
 
 ```shell
-./trailblaze
+trailblaze
 ```
 
 This starts:
 - MCP server on `http://localhost:52525/mcp`
 - Web UI for monitoring
 
+### Quick Setup with `trailblaze mcp install`
+
+The fastest way to configure your MCP client:
+
+```shell
+trailblaze mcp install claude    # Configure Claude Desktop
+trailblaze mcp install cursor    # Configure Cursor
+trailblaze mcp install goose     # Print Goose configuration instructions
+trailblaze mcp install            # Configure all supported tools
+```
+
+### Connecting from Claude Desktop
+
+Run `trailblaze mcp install claude`, or manually add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "trailblaze": {
+      "url": "http://localhost:52525/mcp"
+    }
+  }
+}
+```
+
+### Connecting from Cursor
+
+Run `trailblaze mcp install cursor`, or manually add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "trailblaze": {
+      "url": "http://localhost:52525/mcp"
+    }
+  }
+}
+```
+
 ### Connecting from Goose
 
+Run `trailblaze mcp install goose` for instructions, or manually configure:
+
 1. Download [Goose Desktop](https://block.github.io/goose/docs/getting-started/installation/)
 2. Add a new extension:
    - **ID**: `trailblaze`
    - **Name**: `Trailblaze`
    - **Type**: `streamable_http`
    - **URI**: `http://localhost:52525/mcp`
 
-### Connecting from Firebender/Cursor
+Or add to `~/.config/goose/config.yaml` under `mcpServers`:
+
+```yaml
+trailblaze:
+  type: streamable_http
+  url: http://localhost:52525/mcp
+```
 
-- **ID**: `trailblaze`
-- **Name**: `Trailblaze`
-- **Description**: `A tool to facilitate the creation and execution of mobile ui tests using natural language using the Trailblaze library.`
-- **Type**: `streamable_http`
-- **URI**: `http://localhost:52525/mcp` (use your configured HTTP port if different from the default)
+### Connecting from Firebender
 
 Add to `~/.firebender/firebender.json`:
 

docs/mcp/index.md

@@ -4,7 +4,7 @@ title: Roadmap
 
 ### Recently Completed ✓
 
-- **Multi-Agent V3 Features** ([Mobile-Agent-v3 inspired](decisions/032b_mobile_agent_v3_integration.md)):
+- **Multi-Agent V3 Features** ([Mobile-Agent-v3 inspired](https://arxiv.org/abs/2508.15144)):
   - Exception Handling: Automatic popup, ad, and error recovery
   - Reflection: Self-correction when stuck or looping
   - Task Decomposition: Break complex objectives into subtasks