docs/start here

Answer from your phone

Pair a phone and answer an agent request away from your desk.

This guide gets you from a running host to answering an agent request on your phone. The details are in phone and browser access.

You need a host with a running Vibeke session. See the quickstart.

1. Pair your phone

Choose one way.

In the terminal interface, run Pair a phone from the command palette (prefix then :). Choose the access level and press Enter. A QR code appears.

You can also press prefix then alt+d to open Connections. Switch to the Devices tab with tab, then press n to start pairing.

Or run this in a shell on the host:

vibeke gateway pair

The first time, the command needs a relay and may ask you to sign in. For the hosted relay with an account:

vibeke gateway pair \
  --relay https://cloud.vibeke.dev \
  --app-url https://app.vibeke.dev

2. Open the app

Scan the QR code with your phone, or open the printed link. The link opens app.vibeke.dev.

Compare the device fingerprint on the phone with the one in the terminal. Confirm on both sides. Each invitation works once and expires.

3. Install it to your home screen

On iOS or iPadOS, open the app in Safari. Choose Share, then Add to Home Screen. Open the installed app, then pair it. Push notifications on iOS need version 16.4 or later.

4. Turn on notifications

In the app, go to Settings, then Alerts, then Turn on. Allow notifications. Choose When an agent needs you to get a message when a request waits. Set this on each device.

5. Answer a request

When an agent asks for permission or asks a question, the app shows it and sends a notification. Open it, read the request, choose or type your answer and send it.

The inbox of the phone app shows each waiting request with Deny, Allow always and Allow buttons.

The host must stay awake and online. Closing the terminal does not stop your agents.

Limits

  • Pair with --scope approve or --scope view for limited access. A view-only device cannot start agents.
  • Run vibeke gateway status if the phone cannot connect.
  • Revoke a phone in Connections or with vibeke gateway revoke <id>.

Next steps