Deffatest CLI

AI-powered bug detection for web, mobile, and game applications

Test your applications directly from the command line with autonomous AI-powered bug detection.

Features

• 🤖 AI-Powered Testing - Autonomous bug detection with advanced algorithms
• 🌐 Multi-Platform - Web, mobile (Android/iOS), and game testing
• ⚡ Fast Setup - Install and start testing in under 1 minute
• 📊 Detailed Reports - Comprehensive bug reports with screenshots and videos
• 🔄 Real-Time Updates - Watch test progress live
• 💾 Local Config - Saves preferences locally for convenience

Installation

npm install -g deffatest

Quick Start

1. Authenticate

deffatest auth
# Enter your API key from https://deffatest.online/dashboard

2. Run a Test

Web Application:

deffatest test --url https://myapp.com --duration 2h

Mobile App:

deffatest test --type mobile --path ./app/build/outputs/apk/release --duration 6h

Game:

deffatest test --type game --path ./Builds --duration 12h

3. Check Status

deffatest status <test-id>

# Follow progress in real-time
deffatest status <test-id> --follow

4. Download Report

deffatest report <test-id>

Commands

deffatest auth

Authenticate with your Deffatest API key.

Options:

• --api-key <key> - Provide API key directly (non-interactive)

Example:

deffatest auth
deffatest auth --api-key sk_live_abc123xyz789

deffatest test

Submit a test for your application.

Options:

• -t, --type <type> - Test type: web, mobile, game (default: web)
• -u, --url <url> - Application URL (required for web tests)
• -n, --name <name> - Test name (default: "CLI Test")
• -p, --path <path> - Build path (required for mobile/game tests)
• -d, --duration <duration> - Test duration: 30m, 1h, 2h, 6h, 12h (default: 2h)
• -w, --wait - Wait for test completion (default: false)
• --fail-on-bugs - Exit with error if critical bugs found (default: false)
• --critical-threshold <number> - Critical bugs threshold (default: 1)

Examples:

# Web test
deffatest test --url https://staging.myapp.com --duration 2h

# Mobile test with wait
deffatest test --type mobile --path ./build --duration 6h --wait

# Test with CI/CD failure on bugs
deffatest test --url https://myapp.com --fail-on-bugs --critical-threshold 3

deffatest status <test-id>

Check the status of a running test.

Options:

• -f, --follow - Follow test progress in real-time (default: false)

Examples:

# One-time status check
deffatest status test_abc123

# Follow progress (updates automatically)
deffatest status test_abc123 --follow

deffatest report <test-id>

Download test report.

Options:

• -o, --output <path> - Output file path (default: ./deffatest-report.zip)
• --format <format> - Report format: zip, json, pdf (default: zip)

Examples:

# Download as ZIP
deffatest report test_abc123

# Custom output path
deffatest report test_abc123 --output ./reports/test-report.zip

# Download as JSON
deffatest report test_abc123 --format json --output ./report.json

deffatest config

Manage CLI configuration.

Options:

• --show - Show current configuration
• --set <key=value...> - Set configuration values
• --reset - Reset to defaults

Examples:

# Show config
deffatest config --show

# Set defaults
deffatest config --set defaultTestType=web defaultDuration=2h

# Interactive menu
deffatest config

# Reset all
deffatest config --reset

Configuration

Configuration is stored in:

• Linux/Mac: ~/.config/deffatest/config.json
• Windows: %APPDATA%\deffatest\config.json

Available Settings:

| Setting | Type | Default | Description | |---------|------|---------|-------------| | defaultTestType | string | 'web' | Default test type | | defaultDuration | string | '2h' | Default test duration | | autoWait | boolean | false | Auto-wait for results | | failOnBugs | boolean | false | Fail on critical bugs | | criticalThreshold | number | 1 | Critical bugs threshold |

Use Cases

Local Development

# Test before committing
npm run build
deffatest test --url http://localhost:3000 --duration 30m --wait

CI/CD Integration

# .github/workflows/test.yml
name: Test with Deffatest
run: |
  npm install -g deffatest
  deffatest auth --api-key ${{ secrets.DEFFATEST_API_KEY }}
  deffatest test --url $STAGING_URL --duration 2h --wait --fail-on-bugs

Scheduled Testing

# Cron job (daily at 2 AM)
0 2 * * * deffatest test --url https://production.myapp.com --duration 6h

API Key

Get your API key at deffatest.online/dashboard.

Plans:

• Free: 10 tests/month, 2h max duration
• Pro: Unlimited tests, 12h max duration, $99/month
• Chaos: Enterprise features, API access, custom limits

Requirements

• Node.js >= 14.0.0
• npm or yarn
• Internet connection

Troubleshooting

"Not authenticated"

deffatest auth

"Invalid API key"

• Check your API key at https://deffatest.online/dashboard
• Ensure no extra spaces when copying

"Connection timeout"

• Check your internet connection
• Verify firewall isn't blocking connections to deffatest.online

"Build path not found"

• Ensure the path exists
• Use absolute path if needed: deffatest test --path /full/path/to/build

Support

• Documentation: docs.deffatest.online
• Issues: GitHub Issues
• Email: [email protected]

License

MIT © Deffatest