Skip to main content
This guide covers common issues you might encounter when using Pilot Extension and how to resolve them.

​
Installation Issues

Symptoms: Error message when trying to install the VSIX file.Solutions:
  1. Ensure the VSIX file is not corrupted - re-download it
  2. Check that you have write permissions to the extensions directory
  3. Try installing via command line: 
    code --install-extension /path/to/minitap-pilot-x.x.x.vsix --force
  4. Restart your IDE and try again
Symptoms: Extension installed but commands not available.Solutions:
  1. Reload the IDE window (Cmd+Shift+P → “Reload Window”)
  2. Check the Extensions view to confirm it’s installed and enabled
  3. Look for errors in the Output panel (View → Output → Select “Pilot Extension”)

​
Device Connection Issues

Symptoms: Device doesn’t appear in the device list.Solutions:
  1. Verify USB debugging is enabled on the device
  2. Check ADB connection: 
    adb devices
  3. If device shows as “unauthorized”, accept the USB debugging prompt on the device
  4. Try a different USB cable or port
  5. Restart ADB server: 
    adb kill-server
adb start-server
Symptoms: Simulator doesn’t appear in the device list.Solutions:
  1. Ensure the simulator is booted: 
    xcrun simctl list devices booted
  2. If no simulators are booted, start one: 
    xcrun simctl boot "iPhone 15 Pro"
open -a Simulator
  3. Refresh the device list in Pilot Extension
Symptoms: Cannot connect to device over WiFi.Solutions:
  1. Ensure device and computer are on the same network
  2. First connect via USB, then enable TCP/IP mode: 
    adb tcpip 5555
adb connect <device-ip>:5555
  3. Check firewall settings aren’t blocking port 5555
  4. Some networks block device-to-device communication

​
Streaming Issues

Symptoms: Device screen updates slowly or stutters.Solutions:
  1. Use a USB 3.0 connection instead of USB 2.0
  2. Close other resource-intensive applications
  3. Reduce the streaming resolution in settings
  4. For wireless connections, move closer to the router
  5. Check CPU usage - streaming requires significant processing
Symptoms: Stream panel opens but shows nothing.Solutions:
  1. Check if the device screen is on and unlocked
  2. Some apps block screen capture - try a different app
  3. Restart the stream
  4. Check the Output panel for error messages
Symptoms: Clicking on the stream doesn’t register on device.Solutions:
  1. Ensure the stream panel is focused
  2. Check if the device is locked
  3. Restart the stream
  4. Verify ADB connection is still active

​
Getting Help

If you’re still experiencing issues, report them on Featurebase or reach out to us on Discord.

​
How to Get Your Session ID

The Session ID helps us debug your issue quickly. You can find it below the device screen in the Pilot panel. To copy it: Simply click on the Session ID - it will be copied to your clipboard automatically.
Always include your Session ID when reporting issues - it allows us to see exactly what happened on our end and resolve your problem faster.

​
When Reporting Issues

Please include:
  1. Session ID (click on it below the device screen to copy)
  2. Device type (Android 14, iOS 17 Simulator, etc.)
  3. Steps to reproduce the issue
  4. Error messages from the Output panel
  5. Screenshots or recordings if applicable

Report a Bug

Report bugs and track their resolution

Discord Community

Get help from the community and our team