AI-powered bug detection for web, mobile, and game applications
npm install deffatestbash
npm install -g deffatest
`
Quick Start
$3
`bash
deffatest auth
Enter your API key from https://deffatest.online/dashboard
`
$3
Web Application:
`bash
deffatest test --url https://myapp.com --duration 2h
`
Mobile App:
`bash
deffatest test --type mobile --path ./app/build/outputs/apk/release --duration 6h
`
Game:
`bash
deffatest test --type game --path ./Builds --duration 12h
`
$3
`bash
deffatest status
Follow progress in real-time
deffatest status --follow
`
$3
`bash
deffatest report
`
Commands
$3
Authenticate with your Deffatest API key.
Options:
- --api-key - Provide API key directly (non-interactive)
Example:
`bash
deffatest auth
deffatest auth --api-key sk_live_abc123xyz789
`
---
$3
Submit a test for your application.
Options:
- -t, --type - Test type: web, mobile, game (default: web)
- -u, --url - Application URL (required for web tests)
- -n, --name - Test name (default: "CLI Test")
- -p, --path - Build path (required for mobile/game tests)
- -d, --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 - Critical bugs threshold (default: 1)
Examples:
`bash
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
`
---
$3
Check the status of a running test.
Options:
- -f, --follow - Follow test progress in real-time (default: false)
Examples:
`bash
One-time status check
deffatest status test_abc123
Follow progress (updates automatically)
deffatest status test_abc123 --follow
`
---
$3
Download test report.
Options:
- -o, --output - Output file path (default: ./deffatest-report.zip)
- --format - Report format: zip, json, pdf (default: zip)
Examples:
`bash
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
`
---
$3
Manage CLI configuration.
Options:
- --show - Show current configuration
- --set - Set configuration values
- --reset - Reset to defaults
Examples:
`bash
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
$3
`bash
Test before committing
npm run build
deffatest test --url http://localhost:3000 --duration 30m --wait
`
$3
`yaml
.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
`
$3
`bash
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"
`bash
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`