What you can do from your phone
A phone you paired, directly (Access from your phone) or through the encrypted relay, can do almost everything your Mac or server can. A few things that hand out credentials, run new code on the server, delete work or raise limits stay with the owner token on the computer itself, or with the command line.
#On your phone
- Tasks: start a task or a Manager (with the default worker and budget limits), send follow-ups with files and photos, stop a response, rename a task, turn its web research off, and retire a finished one.
- Decisions: answer questions, decision cards and plugin forms, allow or deny approvals, send or dismiss a held message, and take over the agent's browser when it asks for help (over direct access; the live screen doesn't go through the relay yet).
- Results: read the conversation, review changes, open deliverables and published files (over the relay, files open on the uuBright relay, not on a self-hosted one), merge a PR or waive its review, and see the board.
- Workspaces and chats: create and rename workspaces, switch between them, change a workspace's mode or Git identity, use chats and chat projects, pick a repository the server found.
- Rooms: read and post in rooms and pass hand-offs on.
- Notifications: turn them on for that phone; see Notifications.
- Your drafts and pins follow you (below).
#Only on the Mac or server
These need the owner token, which a paired phone never has. Open the app on the computer itself (or sign in with the owner token), or use the command line:
| What | Where |
|---|---|
| Connect a new phone or browser (pairing code, QR code) | The app on the computer, over its own address, or npm run pair |
| Model access: API keys, Bedrock, CCR | The app with the owner token, or npm run setup |
| Messaging settings (Discord, WeChat, WhatsApp) | The app with the owner token, or the wechat and whatsapp pairing commands |
| Enable or disable a workspace plugin, or list the server's plugins | The app with the owner token, or npm run workspace -- enable-plugin |
| Add a repository by path outside the folders the server scans | The app with the owner token |
| Delete a task (a phone can retire it, which frees its workspace and keeps everything else) | The app with the owner token |
| Set a lead's worker or budget limits, or change an existing task's lead or PR routing | The app with the owner token |
| Change how chats run (their permission mode) | The app with the owner token |
| Track a PR on a task, or start a PR review yourself | The app with the owner token |
| Server setup, health checks, GitHub sign-in, host resources, updates | npm run setup, doctor, github and resources; see Operate your server |
Notification buttons (Allow once and Deny) aren't shown on iPhone and iPad; tap the notification to answer in the app.
#Your drafts and pins follow you
Start a message on your Mac and finish it on your phone. Whatever you type in a message box (a task's follow-up, New task, your Manager's first goal, a new chat) is saved on your server a moment after you stop typing. When you open the same box on another device that has nothing typed in it, your draft is there. If both devices have text, the one saved last wins. Sending a message clears its draft on every device.
Tasks you pin to the top of the task list are pinned on your other devices too, within a few seconds. Pinned chats were already kept on the server.
Drafts stay on your server, only you and your paired devices can read them, and agents never see them. Each draft can be up to 32,000 characters; the server keeps the 500 most recent. Drafts and pins for another computer in the same window stay on the device.
#A question you left unanswered still reaches you
While you're using the app on any device (you tapped, typed or scrolled in the last minute, in a window that has focus), notifications wait: the card just appears. If you walk away without answering, a notification follows three minutes later, as long as the decision is still open and you haven't opened its task since. It waits for quiet hours and joins other decisions like any notification. See Notifications.