Shriram Singh
Back to Projects
Android

PromptTest — Autonomous Mobile QA Engine & CLI

Zero-Code Android Test Crawler, ADB Protocol Engine & Heuristic AI Selector — Published on NPM

Application Screenshots

Click any screenshot to zoom and browse in full resolution (3 views)

670+ on NPM

Weekly Downloads

386 (100% Green)

Automated Tests

Single-File CLI, 280KB

Bundle Size

NPM Registry (CLI & SDK)

Distribution

Project Overview

Engineered PromptTest, an open-source autonomous mobile QA engine and CLI runner distributed via npm. Designed to completely eliminate manual mobile test scripting, PromptTest operates at the ADB protocol layer to autonomously explore application state graphs, detect dead-ends and no-op actions, verify visual regressions, and produce real-time audit reports — all without a single line of test code. Key architectural achievements include building a resilient Hierarchical Depth-First Search (DFS) traversal engine with package jail containment to prevent external app escapes and suppress destructive actions, developing an interactive session recorder that translates live device gestures into reproducible test specs, and integrating a natural language prompt executor with heuristic fallback selector resolution. The engine ships as a single-file bundled CLI (280KB) via ESBuild, with strict TypeScript types and 386 automated unit and integration tests at 100% green.

Key Features & Engineering

  • Autonomous DFS State Graph Exploration: Traverses screen hierarchies, interactive widgets, navigation tabs, and drawers with zero test scripting using Hierarchical Depth-First Search
  • Jail Containment & Foreground Guardrails: Monitors Android dumpsys activity states to prevent launcher escapes and suppress destructive actions (exit/quit/delete/uninstall)
  • Real-Time Interaction Recorder: Captures live touch events, typing, and gestures with instant file auto-flushing into reproducible, repeatable test spec files
  • Natural Language Prompt Runner: Translates plain-English test instructions into deterministic Android UIAutomator element interactions and gesture sequences
  • Heuristic AI Selector Recovery: Multi-strategy element resolution falling back through ID, accessibility label, text content, and XPath when primary selectors fail
  • Comprehensive Visual Audit Reporting: Generates markdown reports with device metadata, execution graphs, screen state trees, and failure screenshots
  • Bulletproof Engineering Rigor: Single-file bundled CLI (280KB) via ESBuild with strict TypeScript and 386 passing automated unit & integration tests (100% green)

Technologies Used

TypeScriptNode.js CLI & SDKAndroid Debug Bridge (ADB)UIAutomator InternalsAutonomous DFS TraversalHeuristic AI ResolverVitest (386+ Tests)ESBuild BundlerNPM Registry
Category:mobile
Platform:Android