Share a workspace
Let other people into a workspace, give each a role, and see who is there and where they point.
Work on one workspace with other people, each in their own Hivemind app. The workspace stays on your computer, or on your host.
Paste this into your coding agent to invite someone into one of your workspaces and let them in.
Show the prompt
Invite a person into one of my Hivemind workspaces from the terminal, and let them in when they ask. 1. Ask me which workspace folder to share, which role to give, how many people may use the link and for how long. Roles: `view` sees the canvas and terminals; `edit` also moves, adds and closes tiles; `terminals` also types into terminals. A link gives at most `terminals`. The `agents` role runs commands on my computer: give it only if I ask, once they are in, with `hive people role <person> agents`. 2. Check this computer can be reached from where they are: `hive network show`. If its first line ends with `(built in: local)`, only people on the same network can join. If they are elsewhere, tell me a network server comes first (the "Set up your own network server" page) and stop. 3. Make the link: `hive share <folder> --role <role> --uses <n> --expires <time, e.g. 2d>`. Give me the link to send them. They paste it under Join in their app, or run `hive join '<link>'`. 4. When I say they have used it, run `hive people requests` and show me who is asking. Let someone in only after I name them: `hive people allow <number>`. Never allow a request I have not confirmed. At the end, run `hive people list` and show me who is in, at which role. Tell me `hive people remove <name>` disconnects someone and stops their link. REFERENCE https://hivemind.griiken.com/guide/multiplayer.md
Nothing is copied to a server. Traffic goes directly between your apps, or through a relay that cannot read it.
Before you start
- People on your network need nothing else. People elsewhere need your own network server.
- Each guest has Hivemind installed.
Roles
A roleWhat a person or a program may do: view, edit, terminals or agents.Glossary → says what each person may do.
Each role can do everything the roles above it can. People and programs get the same four roles.
| Role | For a person, the app says | For a token, API access says | Can |
|---|---|---|---|
view | Can view | View | see the canvas, terminals, agents and their replies, files, diffs, issues and review comments |
edit | Can edit board | Edit | also move, add and close tiles, press widgets, open a tool's tile |
terminals | Can use terminals | Use terminals | also type into terminals (a person once given the keyboard) |
agents | Can drive agents | Drive agents | also start, answer, message, put to sleep and close agents, which means running commands on your computer. A person gets it only while they are here, after a warning. |
Let someone in
- In the workspace's window, open Settings → Connect and press Connect.
- Send them Copy the link.
- When they use it and the three words match, answer Someone else with a role.
The full steps are in Connect your devices.
Check it worked
The guest's face appears at the top right of your window. hive people list shows them, with their role.
Who is there
| You see | Means |
|---|---|
| Faces, top right | Who else is in. A guest clicks one to follow that person's view. |
| Named pointers | Where each person points. Their selection is ringed in their colour. |
| The banner, as a guest | You're in ⟨workspace⟩ on ⟨host⟩'s machine, with Leave. |
To change a role or remove someone:
hive people list
hive people role ana terminals
hive people remove ana # disconnects them; their link stops workingIn the app, People in this workspace on Settings → Connect shows the same, with Remove.
One keyboard per terminal
A terminal's title bar says who has its keyboard.
- Someone who Can use terminals presses Ask for keyboard.
- The holder answers Give or Not now.
The owner takes it back with Take back, or ⌘⇧K / Ctrl+Shift+K in the terminal.
If it didn't
| You see | Do |
|---|---|
This invite has expired or was used. Ask for a new one. | Make a new invite. |
| The guest waits and nothing happens | Answer the request: a notice on your computer, or hive people requests. |
| The workspace is offline for guests | Your computer is asleep. Move the workspace to a host. |
More in Troubleshooting.
Related
- API tokens: programs get the same roles.
- Trust, permissions and privacy
Last validated for Hivemind 2026.10.3.