VS Code Tunnel

A native Android client for VS Code Remote Tunnels with a built-in SSH client, custom overlay keyboard, and SFTP file browser. Designed for server-side development on phones and foldables.

Features

VS Code Tunnel Client

- Connect to VS Code Remote Tunnels via GitHub authentication - Browse and connect to your tunnel machines - Open specific folders via URL (vscode.dev/tunnel/host/path/to/folder) - Multiple simultaneous sessions with suspend/resume - Auto-reconnect on app restart with saved session URLs - Native auth popup handling (GitHub OAuth flow)

Custom Overlay Keyboard

- Gboard-style compact layout with number row, row stagger, and large keys - PC keyboard layout on wide displays (foldables/tablets) with F-keys and nav cluster - Long-press diacritics — hold e → slide to ě, é, ê (Czech/Slovak/Polish) - Quick action bar — one-tap shortcuts: Cmd Palette, Save, Undo, Redo, Search, Terminal - Key repeat — hold any key for auto-repeat (configurable delay/rate) - Haptic feedback — configurable vibration on key press, copy, paste, and word select - Clipboard history — last 10 copied texts, accessible from toolbar - Touchpad — arrow cursor with dynamic cursor type (resize/text/pointer), click, right-click, scroll, drag via Left button hold or double-tap-and-hold

SSH Client

- Saved servers with host, port, username, password/key authentication - Quick Connect — type user@host:port and go - SSH key generation — ED25519 or RSA-4096 directly in the app - SSH key file picker — import .pem keys from device storage - Startup commands — auto-run commands after connection (e.g. cd /app && tmux attach) - Port forwarding — local and remote (L8080:127.0.0.1:80, R3000:localhost:3000) - Auto-reconnect — configurable retry attempts on connection loss - Known hosts (TOFU) — saves fingerprint on first connect, warns on change - Custom snippets — configurable command buttons in terminal toolbar - Mosh support — UDP-based connection via native mosh-client binary (auto-built in CI)

SSH Terminal (xterm.js)

- Full terminal emulator with xterm.js 5.5 - 1-finger scroll — Termux-style: drag to scroll, long-press to select word - Tmux scroll support — automatic set -g mouse on, SGR mouse wheel events - Text selection — long-press to select word + Android-style teardrop handles - Context menu (2-finger tap) — Copy, Paste, Select All, Clear, Search, Export - Terminal search — find text in scrollback (xterm addon-search) - Clickable URLs — detected links open in browser (xterm addon-web-links) - Pinch-to-zoom — adjust font size with two fingers - 2-finger scroll — scroll terminal with two fingers (native Kotlin handler) - 5 color schemes — Default, Solarized Dark, Dracula, Monokai, Linux - Haptic feedback — on word select, copy, and paste actions

SFTP File Browser

- Browse remote filesystems with directory navigation - Multi-select — checkboxes + long-press to select multiple files/folders - Multi-file upload — select multiple files from device at once - Multi-file download — download selected items with progress bar - Recursive folder download — downloads entire directory trees - Recursive folder delete — rm -rf with confirmation - Create directories (mkdir) and delete files

VS Code Enhancements

- Custom DPI/zoom — adjustable zoom level (50-200%) for more content on screen - Arrow cursor — classic pointer with dynamic type (resize ↔↕, text I-beam, hand pointer) - Panel resize — drag panel borders with touchpad (Left button hold or double-tap-and-hold) - Immersive mode — navigation bar hidden globally for maximum screen space

Settings

- Appearance — terminal color scheme, font size, scrollback lines, VSCode zoom % - Keyboard — suppress system keyboard, haptic feedback, key repeat timing - SSH Defaults — port, username, startup command, auto-reconnect, timeout - Security — biometric lock (fingerprint/face/PIN) on app start - Background — foreground service with WakeLock for persistent connections

Quick Start

- VS Code Tunnel: Sign in with GitHub → select your tunnel → VS Code loads in GeckoView - SSH: Tap "+ Add" → enter server details → tap to connect → terminal opens - Quick SSH: Tap "Quick" → type user@host → enter password → connect - SFTP: Tap "Files" on any saved SSH server → browse/upload/download

License

This project is licensed under the MIT License.