name	adb-karrot
description	Karrot app automation with AI Vision - bypass Play Integrity and LIAPP detection, login, and interaction workflows with Claude Vision API integration
version	3.0.0
modularized	true
scripts_enabled	true
tier	3
category	adb-app-automation
last_updated	"2025-12-03T00:00:00.000Z"
compliance_score	100
package_name	com.towneers.www
liapp_class	com.lockincomp.wfcwxdz
ai_features	["claude_vision_api","semantic_element_detection","multi_layer_fallback","cost_optimization"]
dependencies	["adb-screen-detection","adb-navigation-base","adb-workflow-orchestrator","adb-magisk","anthropic (Claude Vision API)"]
auto_trigger_keywords	["karrot","play-integrity","api-hooking","bypass","login","liapp","lockincomp","ai-vision","semantic-detection","smart-detector"]
scripts	[{"name":"adb-karrot-launch.py","purpose":"Launch Karrot app","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-launch.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"},{"name":"adb-karrot-check-detection.py","purpose":"Check if app detects emulator/spoofed environment","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-check-detection.py","zero_context":false,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"},{"name":"adb-karrot-test-login.py","purpose":"Test login with bypass, verify successful authentication","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-test-login.py","zero_context":false,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"},{"name":"adb-karrot-safe-tap.py","purpose":"Detection-aware tap with random delay and coordinate variance","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-safe-tap.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"x","type":"int","required":true},{"name":"y","type":"int","required":true},{"name":"variance","type":"int","default":10,"description":"Random offset in pixels (+/-)"},{"name":"delay_min","type":"int","default":500,"description":"Minimum delay in ms"},{"name":"delay_max","type":"int","default":2000,"description":"Maximum delay in ms"}]},{"name":"adb-karrot-liapp-monitor.py","purpose":"Monitor logcat for LIAPP security events and detection triggers","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-liapp-monitor.py","zero_context":false,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"keywords","type":"list","default":["LIAPP","security","tamper","integrity","root","magisk"]},{"name":"duration","type":"int","default":60,"description":"Monitoring duration in seconds"}]},{"name":"adb-karrot-multi-device.py","purpose":"Run Karrot automation across multiple connected devices","type":"python","command":"uv run .claude/skills/adb-karrot/scripts/adb-karrot-multi-device.py","zero_context":false,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z"},{"name":"karrot_resilient_tap.py","purpose":"Auto-recovery tap with pre/post package verification and banned zone protection","type":"python","command":"uv run .claude/skills/adb/adb-game-karrot/adb-karrot/scripts/karrot_resilient_tap.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"tap","type":"string","description":"Target name or \"x y\" coordinates"},{"name":"launch","type":"flag","description":"Launch Karrot app"},{"name":"recover","type":"flag","description":"Force recovery from misclick"},{"name":"status","type":"flag","description":"Show current status"}],"features":["Pre-tap package verification","Post-tap package verification (1 second delay)","Auto-recovery from misclicks (Play Store, BlueStacks launcher)","Banned zone protection (BlueStacks ad overlays)","Detailed logging to /tmp/karrot-tap-log.json"]},{"name":"karrot_ai_vision.py","purpose":"Claude Vision-based screen understanding and semantic element detection","type":"python","command":"uv run .claude/skills/adb/adb-game-karrot/adb-karrot/scripts/karrot_ai_vision.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"action","type":"string","required":true,"description":"Vision action (analyze_screen, find_element, get_game_state, detect_error)"},{"name":"query","type":"string","description":"Search query for find_element action"},{"name":"device","type":"string","default":"127.0.0.1:5555"}],"features":["Full screen analysis with AI interpretation","Semantic element detection (\"Find Get Started button\")","Game state detection (login screen, home screen, error popup)","Error/popup detection with auto-recovery suggestions",{"Cost":"~$0.005 per request (~0.5 cents)"}]},{"name":"karrot_smart_detector.py","purpose":"Adaptive detection with multi-layer fallback and loop prevention","type":"python","command":"uv run .claude/skills/adb/adb-game-karrot/adb-karrot/scripts/karrot_smart_detector.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"action","type":"string","required":true,"description":"Detection action (find_element, wait_for, detect_state)"},{"name":"target","type":"string","required":true,"description":"Target element or state"},{"name":"method","type":"string","default":"auto","description":"Detection method (auto, uiautomator, template, ocr, ai)"},{"name":"timeout","type":"int","default":30,"description":"Timeout in seconds"}],"features":["Multi-layer detection (UIAutomator → Template → OCR → AI)","Exponential backoff (0.5s → 0.75s → 1.125s → ...)","Loop prevention (max 10 attempts, 30s timeout)","State machine detection (login, home, error, loading)","Automatic fallback to AI when traditional methods fail"]},{"name":"karrot_unified_automation.py","purpose":"Integration layer combining AI vision with traditional automation","type":"python","command":"uv run .claude/skills/adb/adb-game-karrot/adb-karrot/scripts/karrot_unified_automation.py","zero_context":false,"version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z","parameters":[{"name":"action","type":"string","required":true,"description":"Automation action (tap_element, navigate_to, execute_workflow, handle_error)"},{"name":"target","type":"string","required":true,"description":"Target element or destination"},{"name":"workflow","type":"string","description":"Workflow file path for execute_workflow action"}],"features":["AI-powered semantic tap (\"Tap Get Started button\")","Auto-navigation with state detection","Workflow execution with AI fallback","Auto-recovery from errors and misclicks","Smart retry with exponential backoff"]}]
workflows	[{"name":"karrot-login-v3.toon","purpose":"Resilient login workflow with auto-recovery and banned zone protection (RECOMMENDED)","path":".claude/skills/adb/adb-game-karrot/adb-karrot/workflow/karrot-login-v3.toon","version":"3.0.0","last_updated":"2025-12-03T00:00:00.000Z","features":["Auto-recovery at every phase","Pre/post tap package verification","Banned zone protection (BlueStacks ad overlays)","User settings persistence (neighborhood, phone)","Safe tap targets with verified coordinates"]},{"name":"karrot-login.toon","purpose":"Complete login flow with detection avoidance (legacy)","path":".claude/skills/adb-karrot/workflows/karrot-login.toon","version":"2.0.0","last_updated":"2025-12-03T00:00:00.000Z"},{"name":"karrot-detection-avoid.toon","purpose":"Detection avoidance workflow with safe taps and monitoring","path":".claude/skills/adb-karrot/workflows/karrot-detection-avoid.toon","version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z"},{"name":"karrot-error-recovery.toon","purpose":"Error recovery and retry workflow for detection failures","path":".claude/skills/adb-karrot/workflows/karrot-error-recovery.toon","version":"1.0.0","last_updated":"2025-12-03T00:00:00.000Z"}]
color	cyan

Quick Reference (30 seconds)

Karrot App Automation & Play Integrity + LIAPP Bypass

Package: com.towneers.www LIAPP Class: com.lockincomp.wfcwxdz

What It Does: Automates Karrot app interactions. Enables Play Integrity API and LIAPP security SDK bypass via Magisk hooks to allow app usage on unsupported environments.

Core Capabilities:

App Launching: Open Karrot with auto-detection
Detection Checking: Verify if app detects emulator (Play Integrity + LIAPP)
Login Automation: Automated login with detection-aware taps
Bypass Validation: Confirm Play Integrity and LIAPP bypass success
Safe Tap: Random delay (500-2000ms) and coordinate variance (+/-10px)
LIAPP Monitor: Real-time monitoring for security events
AI Vision: Claude Vision API for semantic element detection (~$0.005/request)
Smart Detection: Multi-layer fallback (UIAutomator → Template → OCR → AI)
Auto-Recovery: Package verification and misclick recovery

When to Use:

Testing Karrot app on emulator
Implementing Play Integrity + LIAPP bypass
Automating login and basic navigation
Validating bypass effectiveness
Multi-device automation

Documentation: .moai/docs/guides/liapp-bypass/

Scripts

adb-karrot-launch.py

Launch Karrot application.

# Launch on default device
uv run .claude/skills/adb-karrot/scripts/adb-karrot-launch.py

# Specify device
uv run .claude/skills/adb-karrot/scripts/adb-karrot-launch.py --device 127.0.0.1:5555

# Wait for login screen
uv run .claude/skills/adb-karrot/scripts/adb-karrot-launch.py \
    --wait-text "Login" \
    --timeout 10

# JSON output
uv run .claude/skills/adb-karrot/scripts/adb-karrot-launch.py --json

adb-karrot-check-detection.py

Check if Karrot detects emulator or spoofed environment.

# Quick detection check
uv run .claude/skills/adb-karrot/scripts/adb-karrot-check-detection.py \
    --device 127.0.0.1:5555


uv run .claude/skills/adb-karrot/scripts/adb-karrot-check-detection.py \
    --device 127.0.0.1:5555 \
    --launch \
    --detailed


uv run .claude/skills/adb-karrot/scripts/adb-karrot-check-detection.py \
    --device 127.0.0.1:5555 \
    --check-logcat


uv run .claude/skills/adb-karrot/scripts/adb-karrot-check-detection.py --json

name: Karrot Play Integrity Bypass - Complete Workflow description: Full end-to-end bypass setup and validation version: 1.0.0 parameters: device: "127.0.0.1:5555" module_path: "/sdcard/PlayIntegrityFork.zip" test_email: "test@karrot.example.com" test_password: "bypasstest123" timeout: 30 phases: # PHASE 1: Setup Magisk with Zygisk - id: phase1_magisk_setup name: "Phase 1: Setup Magisk with Zygisk" steps: - id: launch_magisk action: adb-magisk-launch params: device: "{{ device }}" wait_text: "Modules" timeout: 10 - id: navigate_settings action: adb-tap params: x: 100 y: 200 device: "{{ device }}" - id: enable_zygisk action: adb-magisk-enable-zygisk params: device: "{{ device }}" auto_reboot: false # PHASE 2: Install PlayIntegrityFork Module - id: phase2_install_module name: "Phase 2: Install PlayIntegrityFork Module" steps: - id: launch_magisk_again action: adb-magisk-launch params: device: "{{ device }}" - id: navigate_modules action: adb-tap params: x: 100 y: 100 device: "{{ device }}" - id: tap_install_fab action: adb-tap params: x: 400 y: 800 device: "{{ device }}" - id: wait_file_picker action: adb-wait-for params: method: text target: "Select" timeout: 5 - id: select_module_file action: adb-file-select params: path: "{{ module_path }}" - id: wait_install_complete action: adb-wait-for params: method: text target: "Installation complete" timeout: "{{ timeout }}" # PHASE 3: Verify Magisk Module - id: phase3_verify_module name: "Phase 3: Verify Module Installation" steps: - id: check_module_list action: adb-magisk-launch params: device: "{{ device }}" wait_text: "PlayIntegrityFork" timeout: 10 - id: verify_module_enabled action: adb-screenshot-capture params: device: "{{ device }}" # PHASE 4: Launch Karrot and Check Pre-Bypass - id: phase4_check_prebypas name: "Phase 4: Check Detection Pre-Bypass" steps: - id: launch_karrot action: adb-karrot-launch params: device: "{{ device }}" timeout: 10 - id: check_detection_initial action: adb-karrot-check-detection params: device: "{{ device }}" detailed: true # PHASE 5: Configure PlayIntegrityFork - id: phase5_configure_module name: "Phase 5: Configure PlayIntegrityFork Module" steps: - id: wait_karrot_ready action: adb-wait-for params: method: text target: "Login" timeout: 10 - id: note_configuration_needed action: adb-screenshot-capture params: device: "{{ device }}" # PHASE 6: Test Login with Bypass - id: phase6_test_bypass name: "Phase 6: Test Login with Bypass Active" steps: - id: test_login action: adb-karrot-test-login params: device: "{{ device }}" email: "{{ test_email }}" password: "{{ test_password }}" verify_success: true check_bypass: true timeout: "{{ timeout }}" # PHASE 7: Verify Bypass Success - id: phase7_final_verification name: "Phase 7: Final Verification" steps: - id: check_detection_after action: adb-karrot-check-detection params: device: "{{ device }}" check_logcat: true - id: wait_profile_screen action: adb-wait-for params: method: text target: "Profile" timeout: 5 recovery: # Retry on module installation failure - on_error: phase2_install_module action: retry max_attempts: 2 delay: 3 # Fallback for detection check - on_error: phase4_check_prebypas action: adb-screenshot-capture then: continue # Retry login test - on_error: phase6_test_bypass action: retry max_attempts: 2 delay: 2

name: Karrot Error Recovery description: Automated recovery from detection and bypass failures version: 1.0.0 parameters: device: "127.0.0.1:5555" max_retries: 3 retry_delay: 5 phases: - id: diagnose_error name: "Diagnose Detection Error" steps: - id: capture_state action: adb-screenshot-capture params: device: "{{ device }}" - id: check_logcat_errors action: adb-karrot-liapp-monitor params: device: "{{ device }}" duration: 10 keywords: "error,LIAPP,integrity,CLIENT_TRANSIENT_ERROR" - id: identify_error_type action: adb-karrot-check-detection params: device: "{{ device }}" detailed: true - id: recovery_play_integrity name: "Recover Play Integrity Error" condition: "error_type == 'play_integrity'" steps: - id: clear_app_data action: adb-shell params: device: "{{ device }}" command: "pm clear com.towneers.www" - id: verify_pif_module action: adb-magisk-module-check params: device: "{{ device }}" module: "PlayIntegrityFork" - id: relaunch_app action: adb-karrot-launch params: device: "{{ device }}" timeout: 15 - id: recovery_liapp name: "Recover LIAPP Detection" condition: "error_type == 'liapp'" steps: - id: verify_shamiko action: adb-magisk-module-check params: device: "{{ device }}" module: "Shamiko" - id: verify_hide_applist action: adb-magisk-module-check params: device: "{{ device }}" module: "HideMyApplist" - id: force_stop_app action: adb-shell params: device: "{{ device }}" command: "am force-stop com.towneers.www" - id: wait_before_retry action: adb-wait params: duration: "{{ retry_delay }}" - id: relaunch_app action: adb-karrot-launch params: device: "{{ device }}" recovery: - on_error: recovery_play_integrity action: retry max_attempts: "{{ max_retries }}" delay: "{{ retry_delay }}" - on_error: recovery_liapp action: retry max_attempts: "{{ max_retries }}" delay: "{{ retry_delay }}"

Method	Speed	Cost	Accuracy	Use Case
UIAutomator	0.1-0.3s	Free	95%	Static elements with resource IDs
Template	0.2-0.5s	Free	85%	Known UI patterns
OCR	0.5-1.5s	Free	75%	Text-based elements
AI Vision	2-5s	$0.005	99%	Dynamic/complex UIs, fallback

Screen	Element	X	Y	Safe	Description
Welcome	Get Started	720	2350	Yes	Main action button (SAFE: upper part of button)
Welcome	Log In	872	2493	No	Log In link (WARNING: may be in ad zone)
Neighborhood	Find Nearby	720	216	Yes	Find nearby neighborhoods button
Verification	Verify Now	720	2484	Yes	Verify now button (30 sec)
Login	Phone Input	720	400	Yes	Phone number field
Login	Confirm	720	2400	Yes	Confirm/Continue button
Navigation	Back	64	104	Yes	Back navigation

Zone ID	Description	X Range	Y Range	Severity
bluestacks_game_banner	POPULAR GAMES TO PLAY banner	0-1440	2187-2560	Critical
bluestacks_ad_container	Side ad container	840-1440	162-2422	High
bluestacks_search	Search bar	240-1200	178-258	Medium

Setting	Default	Range	Description
Random Delay	500-2000ms	100-5000ms	Delay between taps
Tap Variance	+/-10px	0-50px	Coordinate randomization
Log Keywords	LIAPP, security, tamper, integrity, root, magisk	-	Monitored keywords

Detection Type	LIAPP Method	Bypass Approach
Root Detection	Binary scan for su/Magisk	Shamiko hiding
Tamper Detection	APK signature verification	Keep original APK
Integrity Check	Runtime integrity validation	Hook LIAPP callbacks
Debug Detection	Debugger attachment check	Release mode only

adb-karrot

ソース情報

インストール方法

ソースファイルを確認

このリポジトリの他の Skills

Quick Reference (30 seconds)

Scripts

adb-karrot-launch.py

adb-karrot-check-detection.py

このリポジトリの他の Skills

Quick Reference (30 seconds)

Scripts

adb-karrot-launch.py

adb-karrot-check-detection.py

adb-karrot-test-login.py

adb-karrot-safe-tap.py

adb-karrot-liapp-monitor.py

adb-karrot-multi-device.py

karrot_ai_vision.py

karrot_smart_detector.py

karrot_unified_automation.py

AI Vision Integration

Overview

Architecture

Detection Methods Comparison

Smart Detection Flow

Loop Prevention

AI Vision Use Cases

Usage Examples

Example 1: Traditional Detection (Fast, Free)

Example 2: AI Vision Fallback (Slow, Paid)

Example 3: Semantic Element Detection

Example 4: Error Detection with AI

Example 5: Workflow with AI Fallback

UI Coordinates (1440x2560 Resolution)

Banned Zones (BlueStacks Air 1440x2560)

Detection Avoidance Settings

Workflows

karrot-bypass-playintegrity.toon

karrot-login.toon

karrot-detection-avoid.toon

karrot-error-recovery.toon

Usage Patterns

Pattern 1: Complete Bypass Setup

Pattern 2: Quick Login Test

Pattern 3: Detection Monitoring

Analysis Files (From Previous Research)

Integration Points

Karrot App Detection Mechanism

LIAPP Bypass Methodology

Monitoring LIAPP Events

Required Modules for LIAPP Bypass

Documentation Reference

Test Results (2025-12-03)

Fixes Applied

Integration Test Status

Known Issues

Changelog

v3.0.0 (2025-12-03) - AI Vision Integration

v2.0.0 (2025-12-03) - Auto-Recovery System

v1.1.0 (2025-12-03) - LIAPP Bypass