Experimental Feature — Team Mode is under active development. The author is still exploring how to keep multi-user collaboration genuinely simple while enabling powerful teamwork. APIs and behavior may change between releases.
What Is Team Mode?
Team Mode lets multiple people control the same computer through vibe-remote. Everyone connects to the same agent, shares sessions, and collaborates in real time — no extra server, no admin panel, no seat licenses.
How It Works
┌─────────────┐
Alice (iPhone) ─┤ │
│ Agent │
Bob (iPhone) ─┤ (your PC) │
│ │
Carol (iPad) ──┤ │
└─────────────┘
Every team member installs the iOS app and logs in with the same agent connector (the connector name and password you set on the machine). Once connected, each device appears as a distinct team member.
Identity: Your Device Name Is You
vibe-remote uses a simple convention: your device name is your identity. There are no separate user accounts on the agent side.
When you first connect, the app assigns a default name. To set your name:
- Open the Dashboard tab
- Tap your avatar
- Set a display name (e.g. "Alice")
The same name = the same person. If Alice has both an iPhone and an iPad, she sets the name "Alice" on both devices. The agent groups them as one team member. Her sessions, cron jobs, and messages are all attributed to "Alice" regardless of which device she uses.
Name protection with Passkey: To prevent others from using your name, set a passkey on your profile. Any new device trying to use that name will need to enter the passkey first.
Sharing Sessions
Every session on the agent is visible to all team members. This enables powerful workflows:
- Pair programming — Alice starts a session to fix a bug. Bob opens the same session and sees the AI output in real time. Both can send messages to the AI.
- Handoff — Alice starts a long-running task before leaving. Bob picks up the session later and continues where she left off.
- Review — Carol opens a completed session to review what the AI did, without disturbing the original workflow.
The Sessions tab shows all sessions. Each message is tagged with the sender's name, so you always know who said what.
Quick Start
On the machine (one-time setup):
vibe-remote
# Press 'c' to set connector name, e.g. "myteam"
# Press 'p' to set password, share it with your team
On each team member's iPhone:
- Install vibe-remote from the App Store
- Enter the shared connector name and password
- Set your display name in Dashboard > avatar
- Start collaborating
That's it. No invitations to send, no admin dashboard to configure, no roles to assign.
Tips
- Keep names unique — each person should pick a distinct name so session attribution is clear
- Use passkeys if you want to lock your name across devices
- One agent, one machine — Team Mode is about sharing access to a single computer, not managing a fleet
- Session context — when multiple people are active in a session, the AI sees all messages in order; be mindful of giving conflicting instructions