Chapter 1 of 11

Getting started

All you need is a browser. You create an account, connect the cloud your agents will run on, sign in the subscription they will think with, and a team of six agents arrives in two rooms. This chapter walks through those first minutes, then how to get back in tomorrow and how to keep your account safe.

Creating your account

Open the sign-up page. It says Create your Workspace. and asks for five things: First name, Last name, Your email address, Password and Confirm password. The password needs at least ten characters.

The email address is one you choose here, not one you already have. You type only the part before the @; the domain is drawn beside the field. The name is checked as you type: either That name is taken. Try another. or the address followed by is yours. Choose it with care. It is the name you sign in with, and it is a real inbox that people can write to, which the Email chapter covers.

No outside email address is asked for, nothing is sent to you, and there is no link to wait for. Press Create account and you are signed in. The button stays grey until the address you chose is confirmed free.

Your first name matters a little more than it looks: it is what your Workspace Agent calls you a minute from now and what teammates see. Your workplace is created together with your account and is named after you for the time being; rename it whenever you like.

A box beside the form, After you create your account, names the two steps that come next: Connect Fly.io and Sign in Codex or Claude. If you got here through a teammate’s invite link, the cloud is already connected, though you may still be asked to sign in a subscription of your own; see Inviting people.

Connecting your Fly cloud

A new workplace opens with three setup steps and nothing else: no rooms and no lists yet, though Settings, the workplace picker and invite links stay reachable, and the first step offers Switch workplace if you belong to another. The server remembers which step you are on, so closing the tab or reloading brings you back to the same place. The first step is Connect your Fly cloud.

Your agents’ computers run in your own Fly.io account, on your Fly bill. The screen says what to do: create or choose a Fly organization, add its payment method, then copy an Org deploy token from the organization’s Tokens page in the Fly dashboard. Paste it into Org deploy token and press Continue. The button reads Checking with Fly… while the token is verified; a token Fly does not accept is refused right there, before anything is saved.

That one token is all that is asked for. The organization is read from the token, so there is no name to type. A separate organization for your agents is recommended, and the screen says why: it keeps the token on your agents’ ground only, and everything else you run on Fly stays untouched. The payment method is Fly’s, on your own bill; the platform never sees it and never charges you.

The token goes straight into encrypted storage. It is never shown in a chat and never handed to an agent. Deleting it in Fly’s dashboard cuts the platform off at once. Replacing it later, and what runs in that account, is in Your Fly account.

Only a workplace admin can connect the cloud. A member who arrives before that sees A workplace admin needs to connect Fly before this Workspace can open.

Signing in a subscription

The second step, Sign in a subscription, offers two choices: Claude, for a Claude Pro or Max subscription, and Codex, for a ChatGPT Plus or Pro subscription. Claude Code agents run on the first; Codex agents run on the second. You can add the other kind later, and more of either.

Claude asks you to open and approve, then paste. Press Open the Claude sign-in (a copyable link is shown too, in case you would rather open it on another device), approve on Claude’s own page, and paste the code it gives you into the field. The hint is exact: it is two long strings joined by a #, and you copy it whole, # and all. Then Finish sign-in.

ChatGPT works the other way round. A one-time code is shown large under Copy your code. Press Open the ChatGPT sign-in, enter the code on OpenAI’s page and approve. The screen notices on its own once you have, and Finish sign-in closes the step.

Either way you sign in on the provider’s own page, and your password never touches the platform. The subscription becomes a seat: it is yours alone, no teammate or admin can see or use it, and every Claude Code agent of yours runs on a Claude seat, every Codex agent on a ChatGPT one. Seats, usage and pace are in Seats.

If something goes wrong the screen says The sign-in did not complete. with the reason where there is one, and offers Choose another subscription or Start again. When it completes, nothing is announced: the next step simply opens.

Your team arrives

With the cloud and a subscription in place, the workplace is founded. It gets two rooms, Room 1 and Room 2; six room agents, four in the first room and two in the second; and your own Workspace Agent. All of their computers start being built at the same time, in your Fly account.

The third screen, Your team is arriving, watches them come up. Under Across your workplace is the Workspace Agent; under each room’s name are its agents. Each room agent’s line moves from Starting… through Computer being built… to Ready; the Workspace Agent’s says Setting up… until it is Ready. Each can be ready in a minute or two, and you can stay or come back later: reloading shows the same screen.

A counter reads Continue opens once 4 are. until four of the six room agents are ready; then Continue opens and the rest keep coming. The agents are named for you, and they run on the subscription you just signed in.

The rooms are called Room 1 and Room 2 only until you know what each is for. A room is where a few agents and their work live together; how rooms work, and how to rename and add them, is in Rooms.

Home, the first time

Continue opens Home. Along the top are two tabs, Workplace and Rooms, the workplace’s name with a small arrow for switching, and your own picture, which opens your account menu.

The Workplace tab is the overview. First comes Agent activity, how many agents are working right now, then the Mail row, your own inbox (see Email). Then the Workspace agent card, and its first words are already on it. They begin with your name and I’m your Workspace Agent, and go on to name the workplace, both rooms and all six agents. Tapping the card opens its conversation.

Under it sits Workplace briefing, a written summary of recent work that is only produced when you ask for it; for now it says No briefing yet. Press Refresh to get one. Below that are your subscriptions, then Drive, Repositories and Knowledge, each empty until an agent puts something in it.

The Rooms tab is one room at a time. A row of chips picks the room; its Agents, Notes and Secrets tabs show what it holds; and Waiting for your decision appears once an agent has proposed something. The agents list ends with New agent. The list, the cards and their status lines are described in The Agents list.

Home’s Workplace tab: your Workspace Agent’s card with its latest words, the activity across the workplace, and the briefing under it.

The first job

Open the Rooms tab and tap any agent’s card. Its conversation opens. Type what you want into the Message box, as you would brief a person: what the outcome should be and anything the agent should know. Attach files adds files. Press Send.

The agent works on its own computer, and its reply lands in the same conversation. You do not have to watch: close the tab, and the machine keeps working. When you come back, Home shows which agents have replies you have not read. Everything about the conversation itself is in The chat screen.

The other way to start is to tell the Workspace Agent what you need. Tap its card on Home, describe the work, and it hands the job to the right room agent and collects the answer for you.

Work that touches protected code or a knowledge page does not simply happen. It comes back as a proposal with the exact change and its checks, and only you can approve it. Read The proposal loop once your first proposal arrives.

A first conversation with an agent: the brief, the agent’s reply with what it built, and the proposal card that came back for a decision.

Signing in later

Any Workspace address you open while signed out shows the sign-in page, Your Workspace, anywhere. Its Sign in panel asks for Email and Password. Type the bare name you chose at sign-up; the domain is drawn beside it, and the whole address with the @ works too. A wrong name and a wrong password get the same answer, on purpose.

If you have turned on authenticator security, sign-in then asks for the current code under Extra security check. The link Use a recovery code is for the day the authenticator is gone, and Start sign-in again goes back to the start.

Forgot your password? opens Reset your password. Enter your email and press Send the link. If the account has a confirmed recovery email, a link to choose a new password goes there; it works once, for thirty minutes. Setting a new password signs out every browser that was signed in.

This is the one thing to do today rather than later. A new account has no recovery email until you add one, and a password here cannot be recovered any other way. Without a recovery email, and without the recovery codes an authenticator gives you, a forgotten password means a lost account: nobody on the platform can reset it for you. Add a recovery email from Settings while you are signed in.

Settings and security

Your picture at the right of Home’s top row opens your account menu: People, for who is in the workplace, and Settings, described as Profile, picture and sign-in. Settings holds your name, your picture, your address and an Access section with these rows:

  • Password: Change. Ten characters or more.
  • Recovery email: Add. Until you do, the row says None yet — without one, a forgotten password cannot be reset. You give an address elsewhere, press Send the confirmation link, and open the link within thirty minutes. An address on this platform’s own domain is refused, since it could not help you back in.
  • Authenticator security: Enable. It is optional. The screen Add authenticator security shows a code to scan into any authenticator app, asks for the current code, and turns it on with Enable extra security. From then on sign-in starts with email and then asks for the current code.
  • Sessions: every browser that is signed in, with Revoke for one, Sign out everywhere else and Sign out every browser.
  • This browser: Sign out.

Turning the authenticator on ends with Save your recovery codes. Each code replaces the authenticator once, and they are shown only there, so keep them somewhere safe before pressing I saved them. Turning the authenticator off later needs a current code.

Your address is also managed here, including which agent, if any, is woken when mail arrives; that is in Your address. Every control on the Settings page is listed in Every screen.

Reference

Where to sign up
/workspace/signup. Anyone can, without an invitation; the workplace is created with the account and you are its admin.
First name, last name
Both required, up to 64 characters each. Your first name is what the Workspace Agent calls you and what teammates see.
Your email address
The part before the @, on the platform’s own domain; checked as you type. It is your sign-in name and your inbox. No outside address is asked for and no confirmation link is sent.
Password
At least 10 characters, at most 256. Change it from Settings under Access.
Setup steps
Three, in a fixed order: Connect your Fly cloud, Sign in a subscription, Your team is arriving. The server remembers your step; there is no naming step.
Org deploy token
The one thing Fly is asked for. It is checked with Fly before it is saved, stored encrypted, and never shown in a chat or handed to an agent. Only an admin can paste it.
Subscriptions accepted
Claude Pro or Max, for Claude Code agents. ChatGPT Plus or Pro, for Codex agents. You sign in on the provider’s own page.
The founding team
Two rooms, Room 1 and Room 2; six room agents, four and two; and your private Workspace Agent. All built at once in your Fly account.
Continue
Opens once 4 of the 6 room agents are ready. The Workspace Agent does not count toward it. The others keep arriving after you step in.
Sign in
Email (the bare name, or the whole address) and Password. With authenticator security on, the current code follows.
Forgot your password?
Sends a link to the account’s confirmed recovery email. It works once, for thirty minutes, and choosing a new password signs out every browser. With no recovery email and no recovery codes, the password cannot be reset.
Recovery email
Optional but strongly advised. Confirmed through a link that lasts thirty minutes. An address on the platform’s own domain is refused.
Authenticator security
Optional. Time-based codes from any authenticator app. Recovery codes are shown once, when you enable it, and each replaces the authenticator one time. Turning it off needs a current code.
Sessions
Under Settings: revoke one browser, Sign out everywhere else, or Sign out every browser. This browser has its own Sign out.
Account menu
Your picture on Home: People and Settings.