Workplace and people

A workplace is created with your account and holds everything you and your teammates make. A room is a team inside it: a few agents and their work living together. A new workplace opens with two rooms, and you add or rename rooms whenever you know what each one is for.

What belongs to a room, and stays there:

• agents, each in exactly one room, moved from the agent’s own screen;
• notes, the room’s quick shared context;
• secrets, the keys the room’s agents may use.

What belongs to the whole workplace, reachable from every room:

• repositories, and the proposals made against them;
• knowledge pages;
• sites;
• Drive, the shared files.

So an agent in one room can clone any repository and read any page, but never receives another room’s keys or sees its notes. Save a key in the room where the agents that need it work; see A key belongs to a room.

Rooms are managed from the Rooms tab on Home: Manage rooms opens the Rooms page, where New room asks only for a Room name. Any member can create a room. A room’s own page has Rename this room and, when you are allowed, Delete this room.

Deleting a room is for a workplace admin or the person who created it, and you type the room’s exact name to confirm. Its agents, its notes live and archived, its proposal history, and its keys and their files are removed for good. Repositories, knowledge pages and sites are never deleted with a room.

There are two roles. Whoever creates a workplace is its admin; everyone who joins through an invite link is a member until an admin promotes them. The Workspace puts it in one line: an admin can invite and remove people, change roles, and manage the workplace itself.

Only an admin can:

• connect or replace the Fly cloud, see cloud spending and machine details, and choose the machine size new agents are built on;
• create and revoke the invite link, and approve or decline requests to join;
• change roles and remove people;
• rename and delete the workplace, and delete a room they did not create;
• add, copy or delete a shared key, and decide whose agents receive it;
• grow the workplace’s code storage.

Any member can:

• create rooms and create their own agents, as many as they need;
• use every repository, knowledge page, note and site of the workplace;
• sign in their own subscriptions and save a key for one of their own agents;
• leave the workplace.

Agents are personal. An agent belongs to the person who created it and stays in that workplace for life. Only its owner chats with it, and only its owner decides its proposals. Being an admin does not let you approve a teammate’s proposal, read a teammate’s conversation, or see a teammate’s subscription. Everyone can see every agent, though: its name, its face, its room, who drives it and whether it is working. What it is working on stays with its owner.

One rule protects the whole thing: the last admin cannot leave, be removed or be made a member until another admin exists. Promote someone first.

Tap the workplace’s name at the top of Home and choose Invite to this workplace; only admins have it. The page shows the workplace’s one invite link, creating it if there is none yet, with Copy beside it.

The link names no recipient, works for anyone who has it, and lasts until you revoke it. It gives nobody membership by itself: you approve everyone who asks to join. The link row has a revoke button, which asks Revoke this invite link? first. Revoking stops new requests at once; requests already filed still wait for your decision.

Someone who opens the link while signed out lands on Join your team’s Workspace. They create an account there, or sign in to one they already have. Then comes the join page, titled with your workplace’s name, and its button: Request to join, with Set up my own workplace instead below it. A Joining as line shows which account is asking, with Switch to use another.

Their page then says Waiting for approval. They can close it and come back through the same link; it updates by itself when you decide. On your side, the request appears on Home’s Workplace tab under Join requests, above the Workspace Agent card, and again in Workplace settings. Each row has Decline and Approve.

Approved, they see Access approved and Open workplace, which switches them into it. They always join as a member; promote them afterwards from their screen if you want. Declined, they see Request declined and can Request again while the link is active.

A person who joins walks into a workplace that is already set up: no rooms or agents are made for them. If they have no usable subscription of their own yet, they are asked to sign one in first. Their own account came with a workplace too, so it appears in their list beside yours.

Your picture on Home opens the account menu, and People is on it; the page is also the first row of Workplace settings. Under its heading it says Just you while you are alone, otherwise how many people there are and how many are here now, and once agents have worked, how long they have worked in all.

Each person has a row: face and name, role and agent count such as Admin · 3 agents, and a state: Here now when they have been active in the last three minutes, otherwise when they were last seen or when they joined. A last line says what they did most recently, in facts only, never in message text: messaged an agent, approved a proposal, wrote a note. Beside it are the faces of the agents they drive. People here now come first.

Tapping a row opens that person’s screen: their name, Admin of or Member of the workplace, and the rows Seen, Latest, Email, Agents, Agents worked and Joined, with who invited them. Email starts a message to them from your own address. Each agent under Agents opens its page, read-only for a teammate’s agent: what it is and what it has been doing, nothing you can change.

An admin sees two more things on a teammate’s screen: Make admin or Make member, and at the foot, Remove from workplace. Making someone a member keeps their agents and their work; only what they can manage changes.

To leave, open Workplace settings and find Membership at the bottom; the button is Leave followed by the workplace’s name. The confirmation says what it costs: the agents you own here are permanently retired, your private sign-ins stay yours, and work shared with the workplace stays there. The section is hidden while you are the only member, and the last admin is told to promote another member first.

To remove someone, open their screen from People and press Remove from workplace. The confirmation reads Their agents in this workplace are permanently retired. Their private sign-ins stay theirs. You cannot remove yourself, and nobody can remove the last admin.

Leaving and being removed have the same effect. The person’s agents in that workplace are retired for good and can no longer run; their undecided proposals and requests are withdrawn; and everything shared stays: repositories, knowledge pages, notes, sites and history. Their account, their subscriptions and their other workplaces are untouched. A retired agent still shows in its room’s list, marked Retired.

The workplace’s name at the top of Home is a menu. It lists every workplace you belong to, with a tick on the one you are in and an Admin badge where you are one; tap another to switch. Below the list are Invite to this workplace, Workplace settings and New workplace. The full page, Switch workplace, lists the same and says what a switch means: the whole Workspace follows.

Switching changes only what you are looking at. It never moves an agent, a repository, a note or a key from one workplace to another. A seat you signed in is yours across workplaces and can be used in several at once; see Seats. The admins of one workplace cannot see which other workplaces you belong to, or anything you do there.

New workplace asks for a Workplace name and a press of Create workplace. You are its admin. It is a workplace of your own, with its own rooms, agents, code, knowledge and notes; once its cloud and a subscription are connected, it opens with two rooms and six agents, as your first one did; the steps are in Getting started.

A workplace an admin has asked to delete carries a grey Being deleted badge in the menu and on the page.

Workplace settings, from the menu under the workplace’s name, is the workplace’s own page. Its title is the workplace’s name; beneath are the People row, Join requests, the Invite link, Cloud account, Code, Backups and Membership. At the foot, admins have Rename this workplace and Delete this workplace.

Rename this workplace opens Rename workplace. Type the new Workplace name and press Save name; the page confirms Your workplace is now called the name you chose. A new name is all that changes: its people, rooms, agents, code and shared work stay where they are. Members are not offered the button.

Rooms are renamed separately, one at a time, from the room’s own page, reached through Rooms, with Rename this room.

Any admin can ask to delete a workplace, alone; a member never sees the option. The door is Delete this workplace at the foot of Workplace settings. It opens Delete workplace, which shows the whole cost before you decide. Under What goes is a count across every member and room: rooms, agents, repositories, sites, notes, knowledge pages, Drive and keys. Under What stays: everyone’s account, with their email, private sign-ins and other workplaces; and, if a cloud is connected, your Fly account.

Read that last line plainly. Deleting a workplace removes its records from the platform and lets go of your Fly account, but touches nothing inside that account. The agents’ machines, the apps behind your sites and the storage bucket stay there and keep costing money until you remove them in Fly; Fly’s dashboard shows what each costs.

To confirm, press Delete workplace and type the workplace’s exact name. What happens next depends on whether anything is in it.

An empty workplace is deleted the moment you confirm: you are its only admin and nothing is in it, no agents, repositories, notes, pages, sites, keys, invite link, connected cloud or pending join request. The screen says so: Nothing is in it and nobody else is here, so it is deleted as soon as you confirm.

Any other workplace locks for three days first. Its agents stop and their machines sleep with nothing lost from their disks; nothing new can start there. Every member sees a lock screen instead of the workplace, titled with its name and is being deleted, saying who asked, when, and the day it will be gone for good. Settings, Mail and the workplace picker stay reachable, and everyone is emailed when the deletion is asked for, if it is kept, and when it is done.

Until the three days are up, any admin can press Keep this workplace, on the lock screen or at the top of the workplace’s settings. It comes back exactly as it was, and its agents wake on their next message. After a keep, asking to delete again has to wait an hour. Everyone else on the lock screen has Switch workplace or New workplace.

When the day comes, the platform removes the agents’ records and conversations, the sites’ addresses (the names are freed), the repositories, every proposal, knowledge page, note, key and Drive entry, and the stored Fly token. People’s accounts, subscriptions and other workplaces are not touched. One case is refused outright, with the reason on screen: a workplace whose cloud account still runs a site belonging to another workplace.

Every member has one Workspace Agent, private to them, for the whole workplace. It is not in any room, does not appear in any room’s list or in the counts on the People page, and nobody else can see it or its conversation.

It keeps an eye on every room you can see, hands work to your room agents and collects their answers, and answers you in its own conversation. It is a full agent with its own computer, at the size new agents in the workplace get. Being the coordinator gives it no extra authority: every ownership, admin and approval rule still applies, so it cannot decide a proposal or act on an agent that is not yours.

On Home its card is headed Workspace agent and sits above Workplace briefing. Tap the card to open its conversation; its own screen shows its machine and how full its conversation is, and lets you ask it to start a fresh one. The briefing beneath is a separate written summary, produced only when you press Refresh, and it does not wake the agent. More on both in The Workspace Agent and The briefing.