Truss Go for Android

Truss Go is the Android companion for a Truss workspace already open in Truss Desktop or the Truss VS Code extension. It is for continuing a conversation or agent task from your phone on the same Wi-Fi network. It does not require a Truss account, manual IP address entry, or a copied gateway token in normal use.

Install

The preferred installation method will be Google Play. Until the Play listing is available, install the signed testing APK from the Truss Go page.

Android may ask you to allow the browser or file manager that downloaded the APK to install unknown apps. Only use APKs attached to this project’s official GitHub Releases.

Pair a phone

Open the workspace on the computer where you run Truss Desktop or VS Code.
Select Connect Truss Go.
Open Truss Go on your phone and scan the displayed QR code.
Select the workspace and Chat, Plan, or Edit mode, then send a message.

Both devices must be connected to the same trusted Wi-Fi network. The pairing QR contains the computer’s automatically detected LAN address and a temporary token, so normal setup does not require entering an IP address. The connection continues after you close the QR panel and ends when you select Disconnect or close the host client. Scan again when you want to reconnect.

If Android reports that HTTP works but the live event stream cannot connect, allow Truss through the computer’s firewall for private networks and confirm that both devices are on the same Wi-Fi network.

Approvals and settings

Truss Go follows the approval policy selected in the mobile app. Ask every time shows each requested tool action, Auto-approve reads allows bounded workspace inspection, and Auto-approve all lets an agent proceed without individual prompts. The preference is saved for future sessions, subject to the policies supported by the paired host. Use automatic approvals only for workspaces and tasks you trust.

The mobile app talks to the Truss computer, which retains the workspace, provider configuration, and agent tools. Your phone does not need your model provider credentials.

Managed agents

When the paired host enables managed agents, Truss Go shows an Agents control center with the host-visible profiles, recent runs, live progress, and pending approvals. The host explicitly advertises whether the phone may start, stop, or approve a run, so unavailable controls stay disabled. Create and edit profiles on Desktop, VS Code, or the CLI; the phone never receives provider credentials. See Managed Agents for the shared run and safety policy.

Maintainer release process

The first release needs an Expo account to initialize the EAS project interactively. From packages/mobile, run:


npx eas-cli login
npx eas-cli build --platform android --profile preview

Commit the EAS projectId that the initialization adds to the app config, then add an EXPO_TOKEN repository secret. Tag the committed mobile version as truss-go-v<version> (for example, truss-go-v0.1.0). The Android release workflow builds an APK and attaches it with SHA256SUMS.txt to the matching GitHub Release. The production EAS profile creates the .aab uploaded to Google Play Console.