2026.03.16 (#107)

Author: handstandsam

.github/workflows/build-desktop.yml

@@ -1,4 +1,4 @@
-name: Build Desktop App
+name: Build Desktop JAR
 
 on:
   # Runs on PRs targeting the default branch
@@ -10,6 +10,8 @@ on:
   # Runs after merging to the default branch
   push:
     branches: [ "main" ]
+    tags:
+      - 'v*'
 
   # Allows manual triggering from Actions tab
   workflow_dispatch:
@@ -19,7 +21,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  build-macos-app:
+  build-jar:
     runs-on: macos-latest
     timeout-minutes: 45
 
@@ -42,43 +44,28 @@ jobs:
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
 
-      - name: Build Desktop App
-        run: ./gradlew :trailblaze-desktop:createDistributable
+      - name: Build Shrunk Uber JAR
+        run: ./gradlew :trailblaze-desktop:shrinkUberJar -Ptrailblaze.proguard=true
 
-      - name: Ad-hoc Sign App
-        run: |
-          APP_PATH="trailblaze-desktop/build/compose/binaries/main/app/Trailblaze.app"
-          echo "Signing app bundle with ad-hoc signature..."
-          codesign --force --deep --sign - "$APP_PATH"
-          
-          # Verify signing
-          codesign --verify --verbose "$APP_PATH"
-          echo "App successfully signed"
-
-      - name: Package .app file
-        id: package-app
-        run: |
-          APP_PATH="trailblaze-desktop/build/compose/binaries/main/app/Trailblaze.app"
-          echo "Found .app at: $APP_PATH"
-          
-          # Get directory size for logging
-          du -sh "$APP_PATH"
-          
-          # Create zip archive preserving the .app bundle structure
-          cd trailblaze-desktop/build/compose/binaries/main/app
-          ZIP_NAME="Trailblaze-macos.zip"
-          zip -r -y "$ZIP_NAME" Trailblaze.app
-          
-          # Move zip to root for easier artifact path
-          mv "$ZIP_NAME" "$GITHUB_WORKSPACE/"
-          echo "zip_path=$GITHUB_WORKSPACE/$ZIP_NAME" >> $GITHUB_OUTPUT
-          echo "Created zip: $ZIP_NAME"
-          ls -lh "$GITHUB_WORKSPACE/$ZIP_NAME"
+      - name: Upload Shrunk JAR Artifact
+        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 App Artifact
+      - name: Upload Full Uber JAR Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: trailblaze-desktop-macos-app
-          path: ${{ steps.package-app.outputs.zip_path }}
+          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
+          generate_release_notes: true

.gitignore

@@ -58,3 +58,5 @@ node_modules/
 __pycache__/
 *.pyc
 /sdks/python/.venv/
+
+package-lock.json

.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "trailblaze": {
+      "command": "./trailblaze",
+      "args": ["mcp"],
+      "env": {
+      }
+    }
+  }
+}

docs/CLI.md

@@ -28,6 +28,7 @@ trailblaze [OPTIONS] [COMMAND]
 | `config` | View and modify Trailblaze configuration |
 | `status` | Check if the Trailblaze daemon is running |
 | `stop` | Stop the Trailblaze daemon |
+| `help` | When no COMMAND is given, the usage help for the main command is displayed. |
 
 ---
 
@@ -92,6 +93,7 @@ trailblaze mcp [OPTIONS]
 | Option | Description | Default |
 |--------|-------------|---------|
 | `--http` | Use Streamable HTTP transport instead of STDIO. Starts a standalone HTTP MCP server. | - |
+| `--direct`, `--no-daemon` | Run as an in-process MCP server over STDIO instead of the default proxy mode. Bypasses the Trailblaze daemon and runs everything in a single process. Use this for environments where the HTTP daemon cannot run. | - |
 | `--tool-profile` | Tool profile: FULL or MINIMAL (only device/blaze/verify/ask/trail). Defaults to MINIMAL for STDIO, FULL for HTTP. | - |
 | `-h`, `--help` | Show this help message and exit. | - |
 | `-V`, `--version` | Print version information and exit. | - |
@@ -119,37 +121,49 @@ trailblaze list-devices [OPTIONS]
 
 ### `trailblaze config`
 
-View and modify Trailblaze configuration using positional arguments.
+View and modify Trailblaze configuration
 
 **Synopsis:**
 
 ```
-trailblaze config                           # Show all settings + auth status
-trailblaze config <key>                     # Show a specific key's value
-trailblaze config <key> <value>             # Set a config value
-trailblaze config models                    # List available LLM models by provider
-trailblaze config agents                    # List available agent implementations
-trailblaze config drivers                   # List available driver types
+trailblaze config [OPTIONS] [<<key>>] [<<value>>]
+trailblaze config models
+trailblaze config agents
+trailblaze config drivers
 ```
 
+**Arguments:**
+
+| Argument | Description | Required |
+|----------|-------------|----------|
+| `<<key>>` | Config key to get or set | No |
+| `<<value>>` | Value to set | No |
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-h`, `--help` | Show this help message and exit. | - |
+| `-V`, `--version` | Print version information and exit. | - |
+
 **Config Keys:**
 
 | Key | Description | Valid Values |
 |-----|-------------|-------------|
-| `llm` | LLM provider and model (shorthand) | `provider/model` (e.g., `openai/gpt-4-1`) |
-| `llm-provider` | LLM provider | `openai`, `anthropic`, `google`, `ollama`, `openrouter`, etc. |
-| `llm-model` | LLM model ID | e.g., `gpt-4-1`, `claude-sonnet-4-20250514` |
-| `agent` | Agent implementation | `TRAILBLAZE_RUNNER`, `TWO_TIER_AGENT`, `MULTI_AGENT_V3` |
-| `android-driver` | Android driver type | `HOST`, `ONDEVICE`, `ACCESSIBILITY` |
-| `ios-driver` | iOS driver type | `HOST` |
-| `set-of-mark` | Enable/disable Set of Mark mode | `true`, `false` |
-| `ai-fallback` | Enable/disable AI fallback | `true`, `false` |
+| `llm` | LLM provider and model (shorthand: provider/model) | provider/model (e.g., openai/gpt-4-1, anthropic/claude-sonnet-4-20250514) |
+| `llm-provider` | LLM provider | openai, anthropic, google, ollama, openrouter, etc. |
+| `llm-model` | LLM model ID | e.g., gpt-4-1, claude-sonnet-4-20250514, gemini-3-flash |
+| `agent` | Agent implementation | TRAILBLAZE_RUNNER, TWO_TIER_AGENT, MULTI_AGENT_V3 |
+| `android-driver` | Android driver type | HOST, ONDEVICE, ACCESSIBILITY |
+| `ios-driver` | iOS driver type | HOST |
+| `set-of-mark` | Enable/disable Set of Mark mode | true, false |
+| `ai-fallback` | Enable/disable AI fallback when recorded steps fail | true, false |
 
 **Examples:**
 
 ```bash
-trailblaze config                                    # Show all settings + auth status
-trailblaze config llm                                # Show "openai/gpt-4-1"
+trailblaze config                                    # Show all settings
+trailblaze config llm                                # Show current LLM provider/model
 trailblaze config llm anthropic/claude-sonnet-4-6    # Set both provider + model
 trailblaze config llm-provider openai                # Set provider only
 trailblaze config llm-model gpt-4-1                  # Set model only
@@ -160,6 +174,56 @@ trailblaze config agents                             # List agent implementation
 trailblaze config drivers                            # List driver types
 ```
 
+---
+
+### `trailblaze config models`
+
+List available LLM models by provider
+
+**Synopsis:**
+
+```
+trailblaze config models [OPTIONS]
+```
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-h`, `--help` | Show this help message and exit. | - |
+| `-V`, `--version` | Print version information and exit. | - |
+
+---
+
+### `trailblaze config agents`
+
+List available agent implementations
+
+**Synopsis:**
+
+```
+trailblaze config agents [OPTIONS]
+```
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-h`, `--help` | Show this help message and exit. | - |
+| `-V`, `--version` | Print version information and exit. | - |
+
+---
+
+### `trailblaze config drivers`
+
+List available driver types
+
+**Synopsis:**
+
+```
+trailblaze config drivers [OPTIONS]
+```
+
 **Options:**
 
 | Option | Description | Default |
@@ -206,6 +270,30 @@ trailblaze stop [OPTIONS]
 | `-h`, `--help` | Show this help message and exit. | - |
 | `-V`, `--version` | Print version information and exit. | - |
 
+---
+
+### `trailblaze help`
+
+When no COMMAND is given, the usage help for the main command is displayed. If a COMMAND is specified, the help for that command is shown.
+
+**Synopsis:**
+
+```
+trailblaze help [OPTIONS] [<COMMAND>]
+```
+
+**Arguments:**
+
+| Argument | Description | Required |
+|----------|-------------|----------|
+| `<COMMAND>` | The COMMAND to display the usage help message for. | No |
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-h`, `--help` | Show usage help for the help command and exit. | - |
+
 <hr/>
 
 **NOTE**: THIS IS GENERATED DOCUMENTATION