A VS Code extension providing a seamless UI that lets you do full-stack development right on your Android device.
The main goal of this project is to provide a lightweight VS Code extension that feels like WSL or Remote-SSH, enabling developers to seamlessly browse, edit, and execute code workspaces directly on an Android/Termux device using solely an ADB (Android Debug Bridge) connection.
Unlike standard remote development extensions, it achieves a "Remote-SSH" style user experience without injecting a heavy, network-bound Node.js server binary into the target environment. This completely bypasses architecture constraints and glibc library execution barriers (such as Android’s native reliance on the Bionic C library).
Please note: This project is currently in its beta state. It has not yet been tested across a wide variety of Android devices or custom ROMs, so bugs are expected.
Additionally, most of the codebase was written with the assistance of an AI agent. However, every architectural decision, fallback strategy, and raw ADB command executed under the hood has been deliberately chosen, curated, and vetted to ensure safe and predictable behavior on your device.
Here is a breakdown of the core internal features powering the extension. Click the links for deep dives into how they work under the hood.
| Feature | Description | Full detail | Limitations |
|---|---|---|---|
| 🔌 Device Connection & Management | Robust connection handling for both USB and wireless (TCP/IP) devices with automatic persistent tracking. | Read more | View Limitations |
| 👤 User Switching & Execution Contexts | Seamlessly switch your execution context between shell, root, termux, or custom app sandboxes using run-as. |
Read more | View Limitations |
| 🛠️ Toybox Injection | Automatically injects a statically compiled toybox binary to ensure POSIX-compliant shell tools are always available. | Read more | View Limitations |
| ✅ Pickers & Validation | Interactive UI for folder/file selection with an automated chmod remediation pipeline to fix permission issues. |
Read more | View Limitations |
| 📁 Remote File System & Caching | A lightning-fast native vscode.FileSystemProvider backed by a background tar caching engine. |
Read more | View Limitations |
| 💻 Terminal Integration | Auto-starts an integrated ADB shell configured to your workspace's exact location and execution context. | Read more | View Limitations |