Skip to content

Latest commit

 

History

History
58 lines (41 loc) · 3.07 KB

android.md

File metadata and controls

58 lines (41 loc) · 3.07 KB

Android client

The Android app is a client for a tereditor host on another machine. It shows the same workbench, while projects, settings, plugins and shells stay on the host.

What you can do

  • Browse files, edit code and review changes.
  • Use the host's terminals and agents.
  • Close the app or lose the connection, and the work keeps running on the host.

Layout

  • A wide window gets the desktop layout: the project rail, the centre and the side tools, with Settings in the top bar. That is a tablet in either orientation, an unfolded foldable, or the app's window on a monitor in Android's desktop mode (with a mouse and keyboard, as on the desktop). Wide means at least 600 × 480 dp, or 600 × 360 dp on a tablet or an external monitor, so a 1280×720 px desktop-mode window counts.
  • A phone, in either orientation, and any window narrower than 600 dp put Projects, the current tab, Tools and Settings on separate pages, reached from a bottom bar.
  • The layout follows the window as it is resized, turned, unfolded or moved to another display, and opens again on the same workspace and tab. While a file has unsaved edits, the change waits until they are saved or discarded; agents and terminals keep running on the host through it.

Requirements

  • Android 7.0 or later, on arm64 or x86-64.
  • A running host, either the desktop app with its listener on or the standalone tereditor-host. See Remote hosts and clients.
  • A network the phone shares with the host. The connection uses cleartext WebSockets, so use an encrypted network such as Tailscale.

Connect

Choose one of three ways on the connect screen.

  1. Over Tailscale, which needs no addresses or tokens. See Pair over Tailscale.
  2. By QR code. In the desktop app, show the code in Settings › Host, then choose Scan QR code.
  3. By hand. Enter the host's address and token. The port is 54123 when none is given.

The app remembers the host and connects by itself on the next launch. Settings › Host › Disconnect forgets the token.

Desktop Host settings with the listener running and a QR code for pairing a phone

Screenshots

Connect over Tailscale Claude Code terminal Agent tools
The Android connect screen with a Tailscale host found and a Pair and connect button Claude Code running in a terminal on the host, shown on an Android phone The Android Tools page with the Claude Code pane's Context tab listing instruction files and token counts

Build from source

Building needs macOS or Linux. The tasks install the .NET android workload, the pinned Android SDK, NDK and JDK into mise's shared data directory.

scripts/mise run android run   # build, install on the connected device or emulator, and start
scripts/mise run android apk   # Release package at artifacts/android/tereditor.apk