InspectorQA Agent

Local tunnel agent for InspectorQA — test localhost apps without deploying.

Quick Start

npx inspectorqa-agent --token YOUR_TOKEN --port 3000

How It Works

1. Go to InspectorQA → Settings → Lokal Testning
2. Copy your Tunnel Token
3. Run the agent pointing to your local app's port
4. Use InspectorQA Playground to test your localhost app

The agent creates a secure WebSocket tunnel between your machine and InspectorQA's servers. When InspectorQA needs to test your app, requests are forwarded through this tunnel to your local machine.

Options

| Flag | Short | Description | Required | |------|-------|-------------|----------| | --token | -t | Your tunnel token from Settings | ✅ | | --port | -p | Local port to proxy to | ✅ | | --server | -s | Custom server URL | ❌ | | --help | -h | Show help | ❌ | | --version | -v | Show version | ❌ |

Security

The agent is designed with security as a priority:

• localhost only — Only proxies to 127.0.0.1, never to external addresses
• Port locked — Only connects to the port you specify
• Path traversal blocked — ../ and similar attacks are rejected
• Header sanitization — Cookies and auth headers are stripped from responses
• Body size limit — Max 10 MB per request/response
• Encrypted transport — All communication uses WSS (WebSocket Secure)
• Auto-disconnect — Tunnel closes after 30 minutes of inactivity

Examples

# React app on port 3000
npx inspectorqa-agent --token iqa_abc123... --port 3000

# Next.js on port 3001
npx inspectorqa-agent -t iqa_abc123... -p 3001

# Custom backend on port 8080
npx inspectorqa-agent -t iqa_abc123... -p 8080

Requirements

• Node.js 18 or later
• An InspectorQA account with a tunnel token

License

MIT © ElTigre