Trailblaze
Index
Initializing search
Trailblaze
Trailblaze
Trailblaze
Introduction
Trailblaze CLI
Android On-Device Testing
Architecture
Configuration
Getting Started
Host JVM Unit Tests
LLM Configuration
LLM Support
Logging
Maestro Compatibility
Project Layout
Revyl Cloud Device Integration
Roadmap
Support
Trailblaze Tools
Benchmarks
Benchmarks
Playwright-Native Benchmarks
Devlog
Devlog
Devlog
LLM as Compiler Architecture
Trail Recording Format (YAML)
Maestro as Current Execution Backend
Tool Execution Modes
Tool Naming Convention
Handwritten Agent Loop
Custom Tool Authoring
Desktop Application (Moving Away from IDE-based Execution)
Koog Library for LLM Communication
Kotlin as Primary Language
Logging and Reporting Architecture
Trailblaze MCP
AI Fallback
Device-Specific Trail Recordings
Custom Tool Architecture
App Target Configuration
LLM Provider Configuration
Mobile-Agent-v3 Integration Plan
Trail/Blaze Agent Architecture
Agent Resilience, Maestro Decoupling, and Driver-Specific Hierarchies
Recording Memory Template Substitution
Scripted Tools Vision (TypeScript/QuickJS)
TrailblazeNode — Type-Safe Driver-Specific View Hierarchy
Trail YAML v2 Syntax
Agentic Development Loop
Recording Optimization Pipeline
Waypoints and App Navigation Graphs
MCP STDIO-to-HTTP Proxy for Development
iOS TrailblazeNode Support via IosMaestro
MCP API Redesign: verify→blaze, Mode Defaults, iOS launchApp Fix
Screenshot Format Optimization (WebP Everywhere)
CLI-Based SSO/Auth and Dynamic On-Device Instrumentation Args
Support reasoning_effort in LLM Config
Unified trailblaze-config/ Classpath Layout
Workspace Config Resolution: .trailblaze/ and trailblaze-config/ Conventions
Unified Provider Auto-Detection Across Host and Android
CLI and MCP Session Management: Device State and Multi-Terminal Behavior
Platform-Native Hierarchical Snapshots with Stable Element Refs
Ref-Based Tap Replaces Node ID Tap
Scripted Tools PR A2 — Synchronous Tool Execution from JS
Scripted Tools PR A3 — Host-Side Subprocess MCP Toolsets (Scope)
Scripted Tools PR A3 Phase 1 — Subprocess MCP Client, Lifecycle, and Registration
Scripted Tools Execution Model (QuickJS + Synchronous Host Bridge)
Scripted Tools — MCP Extension Conventions
Scripted Tools PR A3 — MCP SDK Subprocess Toolsets
Scripted Tools PR A5 — MCP Toolsets Bundled for On-Device
Scripted Tools — Toolset Consolidation & Revised Sequencing
YAML-Defined Tools (the `tools:` mode)
Maestro Scripting & Flow Control — Comparison and Self-Validation
runTrail: Trail-as-Tool Primitive (Proposal)
Scripted Tools — MCP Server Integration Patterns (forward-looking)
Waypoint Discovery via `matchWaypoint` — Agent-Driven, Retroactive
@trailblaze/scripting — Authoring Vision & Roadmap (for TS authors)
Scripting SDK — client.callTool Round-Trip
Scripting SDK — Envelope Migration & Callback Transport (D1 + D2)
A TrailblazeTool is a function call (MCP tool, RPC request — same thing)
On-device MCP tool callbacks — direct QuickJS binding
Generated
Generated
Built-in LLM Models
Trailblaze Tools
CLI Usage Scenarios
Functions
Functions
Custom
Custom
assertEquals
assertMath
assertNotEquals
assertNotVisibleWithText
assertVisible
assertVisibleWithAccessibilityText
assertVisibleWithResourceId
assertVisibleWithText
assertWithAi
Compose click
Compose request details
Compose scroll
Compose type
Compose verify element visible
Compose verify text visible
Compose wait
dumpMemory
eraseText
hideKeyboard
inputText
launchApp
longPressElementWithAccessibilityText
longPressOnElementWithText
networkConnection
objectiveStatus
openUrl
pasteClipboard
playwright desktop launchGoose
pressBack
pressKey
rememberNumber
rememberText
rememberWithAi
Revyl assert
Revyl back
revyl doubleTap
Revyl navigate
revyl pressKey
Revyl swipe
Revyl tap
Revyl type
scrollUntilTextIsVisible
setActiveToolSets
setClipboard
Swipe
takeSnapshot
Tap
tapOnElementWithAccessibilityText
tapOnElementWithText
tapOnPoint
Wait
Web click
Web hover
Web navigate
Web press key
Web request details
Web scroll
Web select option
Web snapshot
Web type
Web verify element visible
Web verify list visible
Web verify text visible
Web verify value
Web wait
Generator
Generator
Index
Mcp
Mcp
MCP Integration
Index
This is a utility to generate Markdown documentation of Trailblaze Tools.