Controlling Sessions from Android

Once your Android app is paired with your Mac, it mirrors the sessions. The vord app is the terminal companion. The Mac remains the place where the agent runs; the phone is a remote control and view.

vord: the terminal companion

Use vord when you need the terminal-oriented view of your sessions:

• see sessions and their current state;
• open a session and follow its terminal output;
• send terminal input;
• use special keys such as arrows, Tab, Escape, Enter, and control keys;
• answer questions, permission requests, and plan approvals with cards;
• load older terminal history;
• open files or media that an agent shows you; and
• share a session when sharing is available for the account and session.

The phone does not resize the Mac’s terminal or run the session locally. If the Android app disconnects, the session continues on the Mac and the phone can reconnect later.

Answering a session that needs you

When a session asks a question, requests permission, or waits for a plan approval, the companion shows an answer card. Tap the requested option and follow the card’s confirmation step. If the card offers a text answer, enter it and send it from the card’s input area.

Answer cards are the safe place to answer a waiting session. Terminal input and special keys remain available for the cases where the session expects terminal input.

Files and history

The companion can carry the same practical work away from the Mac:

• Files shown by the agent: open a file from the shown-files area when you need to inspect it on the phone.
• History: load older terminal history when you scroll back.

These actions still use the paired connection. They are not an offline queue for commands or messages.

Multiple Macs and shared sessions

You can pair more than one Mac and keep each host’s sessions separate. Select the host before opening its session. A shared session is still tied to the host that owns it; the phone does not merge sessions from different Macs just because their names match.

The companion also supports the session-sharing flow when it is available for your account. A shared session gives the access that was granted by its owner; it does not silently turn view-only access into typing access.

Android compared with iPhone

The Android companion follows the same companion model and feature set as the iPhone companion: pairing, session control, cards, shown files, history, the notification inbox, multiple Macs, and session sharing. The differences currently relevant to users are:

• Android is distributed as a directly installable APK while the Play Store listing is still unpublished.
• Android uses Android system permission dialogs for camera, files, microphone, and notifications.
• Notifications while the Android app is closed need the Firebase integration, which is still outstanding. See Android Notifications.

For the iPhone-specific presentation, see Controlling Sessions from Your iPhone.