Argus

Appearance

Mobile App ​

The mobile app for iOS and Android shows your sessions, status, transcripts, live screen, prompts, and history. It sends you a push notification when a session needs you. You can group the session list by host, project, workspace, agent, or status.

Argus Android app: sessions, transcript, and history

Install ​

To test new versions before they reach the stores, join the beta:

Pairing ​

The app talks to a gateway over the network, so you need a running gateway. Even on a single machine, start the node in gateway mode (argus start --token <TOKEN>) instead of as a plain local node. A local node listens only on a unix socket, which the device cannot reach. Then expose the gateway (a tunnel is the easiest way) and pair the device.

Pairing creates a per-device token. Each device 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 new token, prints a QR code, and waits for the device to connect.

Scan the QR in the app. The gateway stores the token (which makes it revocable) only after a device 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 connect over SSH to a loopback-bound gateway, the same setup the CLI uses over SSH. Tap Add connection and keep SSH selected. The app can import an OpenSSH private key or generate one, and the device keystore stores it. The app pins the host key on the first connection (trust-on-first-use) and rejects a later change.

Push Notification ​

The app notifies you as soon as a session needs you (a prompt, a question, a finished turn), even when it is in the background or killed.

iOS: push runs over APNs through PushPort. Register your gateway with PushPort once, and the app turns on push at its next connection.

Android: push runs over UnifiedPush, so it works on any Android device:

  • Google Play devices: works without setup.
  • De-Googled devices: install any UnifiedPush distributor (for example ntfy), then select it in Settings → Push Notifications → Distributor.
  • PushPort: an alternative to UnifiedPush. See the PushPort guide.

Voice Input ​

To dictate prompts, pick a provider in Settings → Voice Input:

  • System uses the device's speech recognizer. Recognition runs on the device when it can. Otherwise Apple or the Android speech service processes the audio.
  • OpenRouter uses your own OpenRouter key. Save the key and pick a model. Audio goes straight from the device to OpenRouter, never through the gateway, and is billed to your account.