Works with both VS Code and Antigravity!
Connect to your Android phone via ADB WiFi or USB β right from your editor. Manage your device, take screenshots, record your screen, install APKs, control power settings, and more, all without leaving your coding environment.
No Android Studio needed. Whether you're a seasoned developer or just getting started with code vibing in Antigravity, PhoneLink puts your Android device right in your sidebar. Grab screenshots, check logcat, install APKs β all in one click.
- π± Status Bar Icon β Shows connection status at a glance (green when connected)
- Sidebar Panel β Beautiful webview UI for managing your phone connection
- β‘ USB & WiFi β Connect via USB instantly or wirelessly via IP
- Device Info β See model, Android version, battery level, and resolution
- πΈ Screenshot β Capture screenshots with one click
- π₯ Screen Record β Record your phone screen (up to 180 seconds)
- βοΈ Wake / Unlock β Remotely wake and unlock your device screen
- π Stay Awake β Toggle keeping your screen on while plugged in
- π Logcat β Open a live logcat terminal for debugging
- π» ADB Shell β Open an interactive ADB shell
- π¦ Install APK β Install APKs directly from your file explorer
PhoneLink is not yet on the VS Code Marketplace. You can install it manually in VS Code or Antigravity:
- Download the latest
.vsixfrom Releases - Open the Command Palette (
Ctrl+Shift+P) - Run Extensions: Install from VSIX...
- Select the downloaded
.vsixfile
git clone https://github.com/noob1989/phonelink.git
cd phonelink
npm installThen press F5 in VS Code / Antigravity to launch the Extension Development Host with PhoneLink loaded.
- ADB must be installed and available in your PATH (or set the path in extension settings)
- USB Debugging must be enabled on your phone (how to enable)
- For WiFi mode only: Your phone and PC must be on the same WiFi network
- Open the PhoneLink panel from the sidebar (phone icon)
- USB: Plug in your phone and click Scan for Devices
- WiFi: Connect via USB once, run
adb tcpip 5555, unplug, and enter your IP - You're in! Use the panel buttons for screenshots, recording, shell, and more.
Android 11+: You can skip the USB step entirely β use the built-in Wireless Debugging feature in Developer Options.
If you've connected before, just enter your phone's IP!
Configure via File > Preferences > Settings and search for "PhoneLink":
| Setting | Default | Description |
|---|---|---|
phonelink.defaultIp |
"" |
Default phone IP for quick connect |
phonelink.defaultPort |
5555 |
Default ADB TCP port |
phonelink.adbPath |
"adb" |
Path to ADB executable if not in PATH |
All commands available via Ctrl+Shift+P:
| Command | Description |
|---|---|
PhoneLink: Connect to Phone |
Connect to your device via saved IP |
PhoneLink: Disconnect Phone |
Disconnect the current device |
PhoneLink: Open Panel |
Focus the PhoneLink sidebar panel |
PhoneLink: Take Screenshot |
Capture a screenshot from your device |
PhoneLink: Screen Record |
Record the screen (1β180 seconds) |
PhoneLink: Open Logcat |
Open a live logcat terminal |
PhoneLink: Open ADB Shell |
Open an interactive shell session |
PhoneLink: Install APK |
Browse and install an APK file |
Make sure ADB is installed and in your system PATH. You can also set the full path in settings via phonelink.adbPath.
- Windows: ADB comes with Android Platform Tools. Download, extract, and add the folder to your PATH.
- macOS/Linux:
brew install android-platform-toolsor download from the link above.
- Make sure your phone and PC are on the same WiFi network
- Check if your firewall is blocking port
5555 - Try re-running
adb tcpip 5555with your phone connected via USB
- WiFi ADB can drop when the phone goes to sleep β use the Stay Awake toggle in the panel to prevent this!
- Reconnect using the sidebar panel or
PhoneLink: Connect to Phone
- Check your phone for an "Allow USB debugging?" popup and tap Allow
- If the popup doesn't appear, revoke USB debugging authorizations in Developer Options and reconnect
Planned features for future releases:
- π VS Code Marketplace β Publish to the Marketplace for one-click install
- π File Explorer β Browse and transfer files to/from your device
- π Notification Mirroring β See phone notifications in VS Code
- π± Multi-Device β Manage multiple connected devices simultaneously
- πͺ Screen Mirror β Live screen mirroring in the sidebar
Have an idea? Open an issue!
Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.
- π€ Built with the help of Antigravity AI coding assistant
- β‘ Powered by the VS Code Extension API & Android Debug Bridge (ADB)
This project is licensed under the MIT License.