Skip to content

noob1989/phonelink

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PhoneLink πŸ“±

Version License VS Code Antigravity Android

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.

Features

  • πŸ“± 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

Installation

PhoneLink is not yet on the VS Code Marketplace. You can install it manually in VS Code or Antigravity:

From .vsix file

  1. Download the latest .vsix from Releases
  2. Open the Command Palette (Ctrl+Shift+P)
  3. Run Extensions: Install from VSIX...
  4. Select the downloaded .vsix file

From source

git clone https://github.com/noob1989/phonelink.git
cd phonelink
npm install

Then press F5 in VS Code / Antigravity to launch the Extension Development Host with PhoneLink loaded.

Prerequisites

  1. ADB must be installed and available in your PATH (or set the path in extension settings)
  2. USB Debugging must be enabled on your phone (how to enable)
  3. For WiFi mode only: Your phone and PC must be on the same WiFi network

Quick Start

  1. Open the PhoneLink panel from the sidebar (phone icon)
  2. USB: Plug in your phone and click Scan for Devices
  3. WiFi: Connect via USB once, run adb tcpip 5555, unplug, and enter your IP
  4. 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!

Settings

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

Commands

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

Troubleshooting

"ADB not found"

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-tools or download from the link above.

Connection times out (WiFi mode)

  • 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 5555 with your phone connected via USB

Device disconnects randomly

  • 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

"Device unauthorized"

  • 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

Roadmap

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!

Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.

Built With

  • πŸ€– Built with the help of Antigravity AI coding assistant
  • ⚑ Powered by the VS Code Extension API & Android Debug Bridge (ADB)

License

This project is licensed under the MIT License.

About

πŸ“± Connect to your Android phone via ADB WiFi or USB β€” right from VS Code and Antigravity

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors