Skip to content

Mobile App

A companion Android app (in app/) mirrors the TUI — sessions, status, transcripts, live screen, prompts, history — and adds Push Notification: it pings you the moment a session needs you (a prompt, a question, a finished turn) even when backgrounded or killed.

Argus Android app — sessions, transcript, and history in your pocket

Install

The app is in Closed Testing on Google Play — anyone can join:

  1. Join the argus-android-app-beta Google Group with the Google account you use on the device.
  2. Open the testing opt-in link and tap Become a tester.
  3. Follow the link to install Argus from the Play Store.

Updates then arrive automatically through the Play Store like any other app.

Pairing

The app talks to a gateway over the network, so you need one running — even on a single machine, start the node in gateway mode (argus start --token <TOKEN>) rather than a plain local node, which only listens on a unix socket the phone can't reach. Then expose the gateway — a tunnel is easiest — and pair the device.

Pairing mints a per-device token so each phone connects with its own revocable credential instead of the master token. Run argus pair against the gateway:

sh
argus pair --gateway wss://gateway.argus --token <TOKEN>

Argus asks the gateway for a fresh token, prints a QR code, and waits for the device to connect.

Scan the QR in the app. The token is persisted on the gateway — and thus revocable — only after a device actually connects.

Revoke a device with argus unpair:

sh
argus unpair --gateway wss://gateway.argus --token <TOKEN>

Connect over SSH

Instead of exposing the gateway publicly, the app can tunnel its connection over SSH — the same loopback-bound gateway the CLI reaches over SSH. In the app's manual entry screen, switch to SSH and provide the host, user (optional — defaults to root), the gateway's loopback port (default 8443), your token, and an OpenSSH private key (imported or app-generated). The key is stored in the device keystore; the host's key is pinned on first connect (trust-on-first-use) and a later change is rejected.

Push Notification

The app pings you the moment a session needs you — even when backgrounded or killed. Nothing to configure; push is always on.

Push runs over UnifiedPush, so it works on any Android:

  • Google Play devices — works out of the box, no setup.
  • De-Googled devices — install any UnifiedPush distributor (e.g. ntfy), then select it in Settings → Push notifications.