Remote Terminal

Android SSH client built for e-ink devices (BOOX) and phones. Connects to a host over network SSH or USB (via ADB port forwarding).

Features

• SSH mode: Connect to any host over the network
• USB mode: Connect to a laptop over USB using adb reverse — no network needed
• Terminal with real-time keystroke input (characters sent to PTY as you type)
• Special key toolbar: Esc, Tab, Ctrl combos, arrow keys
• ANSI escape sequence handling for CLI tools (Claude Code, etc.)
• E-ink optimized theme (high contrast black on white)
• Connection settings persist across app restarts

USB Connection

1. Connect your device to your laptop via USB
2. On the laptop, run:

   adb reverse tcp:2222 tcp:22
   

3. In the app, switch to USB mode
4. Enter your username/password and tap Connect

Auto-setup on boot

Run the setup script to install a udev rule that automatically sets up port forwarding when the device is plugged in:

bash setup-usb-boot.sh

Build

./gradlew assembleDebug
adb install -r -d app/build/outputs/apk/debug/app-debug.apk