Veritas MCP v1.2.0

Stop claiming your mobile apps work without proof. Veritas MCP actually tests them.

🎯 The Problem

You build an Android app, claim it works, but:

• Never actually installed it on an emulator
• Never verified the UI loads correctly
• Screenshots pile up on your desktop
• APK files consume disk space
• No proof your "fixes" actually work

Result: False confidence, wasted time, frustrated users.

✅ The Solution: --vr5 Flag

One command that actually proves your app works:

# Build your Android app, then verify it ACTUALLY works:
./gradlew assembleDebug
--vr5 verify android build/outputs/apk/debug/app-debug.apk

# iOS verification with automatic cleanup:
--vr5 verify ios --scenarios launch,ui_interaction

# Web app verification:
--vr5 verify web --url http://localhost:3000

What --vr5 does:

1. 🚀 Launches your app on real emulators/simulators
2. 🔍 Tests core functionality automatically
3. 📸 Captures evidence (screenshots, logs)
4. 🧹 Cleans up files after verification
5. ✅ Reports actual success/failure with proof

🚀 Quick Setup (2 minutes)

Install via Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "veritas-mcp": {
      "command": "npx",
      "args": ["veritas-mcp"],
      "env": {}
    }
  }
}

Install via npm

# Global installation (recommended)
npm install -g veritas-mcp

# Or local installation
npm install veritas-mcp

Setup Verification Environment

Android:

# Ensure Android SDK is installed
export ANDROID_HOME=/path/to/android/sdk
--vr5 setup android

iOS:

# macOS only - Xcode required
--vr5 setup ios --simulator "iPhone 15 Pro"

That's it. You're ready to verify.

🧠 Intelligent Asset Management

The Problem: File Chaos

• Screenshots scattered everywhere after testing
• APK/IPA files consuming GBs of disk space
• Old build artifacts never cleaned up
• No idea which files are still needed

The Solution: Smart Cleanup

Veritas MCP v1.2.0 introduces Intelligent Asset Management that:

📍 Tracks Everything:

• When Claude reads your files
• Which screenshots were captured for evidence
• What APK/IPA files were installed
• Which build artifacts are still referenced

🧹 Cleans Automatically:

• Screenshots: Deleted 2 hours after evidence capture
• APK Files: Removed 4 hours after successful installation
• IPA Files: Cleaned up after simulator deployment
• Build Artifacts: Temporary files deleted in 30 minutes
• Cache Files: Smart size and age-based cleanup

🛡️ Preserves Intelligently:

• Keeps files when verification fails (for debugging)
• Protects recently accessed files
• Maintains evidence until verification completes

💾 Works in Background:

• Scans every 5 minutes for unused files
• Cleans up every 15 minutes automatically
• Zero manual intervention required

📱 Real Usage Examples

Scenario 1: Android Bug Fix

# You fixed a login bug, now prove it works:
./gradlew assembleDebug
--vr5 verify android app/build/outputs/apk/debug/app-debug.apk

# Veritas will:
# ✅ Launch app on emulator
# ✅ Test login functionality  
# ✅ Capture success screenshots
# ✅ Clean up APK file after verification
# ✅ Report: "Login works, verified on Medium_Phone_API_36.0"

Scenario 2: iOS App Store Submission

# Before submitting to App Store, verify it actually works:
--vr5 verify ios --scenarios launch,ui_interaction,navigation

# Veritas will:
# ✅ Test on iOS Simulator
# ✅ Verify all critical user flows
# ✅ Upload to DeployGate for team testing
# ✅ Clean up IPA files automatically
# ✅ Generate verification report with evidence

Scenario 3: Web App Deployment

# Before deploying to production, verify functionality:
npm run build
npm start &
--vr5 verify web --url http://localhost:3000

# Veritas will:
# ✅ Test in real Chrome browser
# ✅ Verify responsive design
# ✅ Check JavaScript functionality
# ✅ Monitor network requests
# ✅ Clean up screenshots and temp files

🎯 Core Features

🔍 Smart Emulator Discovery

• Automatically finds Android emulators (5-layer detection)
• Starts emulators if needed
• Handles multiple AVDs intelligently
• 24h caching for performance

📸 Evidence Capture

• Screenshots of successful verification
• Error logs when things fail
• Performance metrics
• Network request logs

🧹 Zero-Maintenance Cleanup

• Files deleted automatically after use
• Configurable retention policies
• Orphaned file detection
• Smart space management

🚀 Cross-Platform Support

• Android APK verification
• iOS IPA testing
• Web application validation
• Works on macOS, Linux, Windows

⚙️ Configuration

Custom Cleanup Policies

# Configure how long to keep files (optional)
--vr5 config cleanup --screenshots 1h --apk-files 2h --temp-files 10m

Emulator Preferences

# Set preferred Android emulator (optional)
--vr5 config android --emulator "Pixel_6_API_34"

iOS Simulator Setup

# Configure iOS testing (optional)
--vr5 config ios --simulator "iPhone 15 Pro" --deploy-gate-upload true

🔧 Advanced Usage

Batch Verification

# Verify multiple platforms at once
--vr5 verify all --android app.apk --ios app.ipa --web http://localhost:3000

Custom Test Scenarios

# Run specific test scenarios
--vr5 verify android app.apk --scenarios launch,login,payment,logout

CI/CD Integration

# Perfect for GitHub Actions, Jenkins, etc.
--vr5 verify android $APK_PATH --headless --report-format json

📊 Usage Reports

Get Cleanup Statistics

--vr5 report cleanup
# Shows: Files cleaned, space reclaimed, cleanup frequency

Verification History

--vr5 report history  
# Shows: Recent verifications, success rates, performance metrics

File Usage Analysis

--vr5 report files
# Shows: Tracked files, disk usage, recommendations

🆘 Troubleshooting

Android Issues

# Check emulator status
--vr5 status android

# Common fixes:
export ANDROID_HOME=/path/to/android/sdk
--vr5 setup android --reset-emulators

iOS Issues

# Check simulator status
--vr5 status ios

# Common fixes:
xcrun simctl list devices
--vr5 setup ios --reset-simulators

File Cleanup Issues

# Check what's being tracked
--vr5 report files

# Force cleanup now
--vr5 cleanup --force

# Reset cleanup policies
--vr5 config cleanup --reset

🏗️ Architecture

Built for Reliability:

• Test-Driven Development (TDD) methodology
• 100% test coverage on core components
• 5-layer emulator detection system
• Intelligent error recovery
• Resource leak prevention

Performance Optimized:

• Smart caching and parallel operations
• Background cleanup (no blocking)
• Minimal resource footprint
• Fast cold start times

📝 What's New in v1.1.0

🧠 Intelligent Asset Management

• File Usage Tracking: Knows which files Claude accesses and when
• Automatic Cleanup: Background cleanup every 15 minutes
• Smart Preservation: Keeps files when verification fails
• Space Optimization: Configurable retention policies by file type

🚀 Performance Improvements

• 60% faster emulator discovery with caching
• Background operations don't block verification
• Reduced memory footprint
• Better error recovery

🔧 Enhanced Configuration

• Granular cleanup policies per file type
• Custom verification scenarios
• Advanced reporting and analytics
• CI/CD friendly options

📞 Support

Quick Help

--vr5 help
--vr5 help android
--vr5 help cleanup

Issues & Documentation

• Issues: GitHub Issues
• Documentation: Full API Reference
• Examples: Integration Examples

Stop making claims. Start providing proof.

Use --vr5 to verify your mobile apps actually work. 🚀

Veritas MCP: Because verification should be bulletproof 🛡️