~/docs/mobile

Mobile companion

The mobile companion puts your agent team in your pocket: get notified when an agent finishes, read its summary, and send follow-up instructions without walking back to the desk.

Getting started

  1. Install the companion app — iOS App Store or grab the Android APK from the releases page.
  2. In Wakii desktop, open Settings → Mobile and scan the pairing QR code.
  3. Agents, notifications, and prompts now sync to your phone.

What you can do

  • Monitor — live agent status, current task, and recent output
  • Get notified — agent finished, needs input, or hit an error
  • Send follow-ups — type a follow-up prompt; it lands in the agent’s queue
  • Approve — clear permission gates from the phone

When it shines

  • Long runs — start a big refactor on the desktop, get pinged when it’s done, read the summary on the couch.
  • Parallel agents — five agents in five worktrees; your phone is the scoreboard.
  • Quick fixes — spot a typo in the agent’s output, send the fix from your phone, done by the time you’re back.

Tips

  • Notifications respect your phone’s focus mode — agent errors break through, “done” pings wait.
  • The pairing is per-machine — one QR per desktop app instance.