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.
Install
The app is in Closed Testing on Google Play — anyone can join:
- Join the argus-android-app-beta Google Group with the Google account you use on the device.
- Open the testing opt-in link and tap Become a tester.
- 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:
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:
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.
