Accounts, organizations & members

How you sign in, how your team's shared space works, and who can do what.


Your account is you. An organization is the shared space your team works in: it owns projects, tasks, runs, connected services, members, and usage. One account can belong to any number of organizations.

Your account is your email address

A confirmed email address is the account. Everything else — a password, a GitHub login, a Google account, a Linear user — is a way in, and one account can hold as many as you like.

So you can sign up with Google, add a password six months later because you left that Google account behind, attach GitHub because a teammate's approver rule names it, and drop Linear when you stop using Linear. You land on the same account every time, because the email decides.

Signing up sends a six-digit code to the address you gave, and the account exists once you confirm it.

Managing how you sign in

Settings → Sign-in methods — on the web, the desktop app, the Mac, both phones, and in the editor's command palette — lists every way into your account. From there you can:

  • Add a provider, or remove one.
  • Set or change your password. Changing it ends every other session and keeps the one you are on.
  • Change your email address. The old address is warned when you ask for the change, not after it lands.
  • Turn on two-factor authentication with an authenticator app, from the account page on the web or the desktop app. Once it is on, every sign-in asks for the code — on every device.
  • See the devices signed in as you, end one, or end all but this one.
  • Delete your account.

The last way in is refused before it is offered: if removing a provider would leave you with no way to sign in, the button says so rather than failing afterwards.

Several accounts on one device

Phones, the Mac, and the web can be signed in as more than one account at once, and switching between them is instant — no password, nothing signed out. Each account keeps its own notifications and cached work, so coming back is immediate.

Create or join an organization

Signing up creates only your account. Onboarding then asks you to create an organization — you become its admin — or join one with an invite link. You can create more later from the organization switcher.

Roles

RoleCan
MemberCreate tasks, start and watch runs, review gates, use every day-to-day surface.
AdminEverything a member can, plus manage members and invites, connected services, project configuration, git access, API keys, machines, apps, and billing.

Change a role or remove somebody from Members. Peractor refuses to demote or remove an organization's last admin, so an organization can never lock itself out.

Admin-only screens stay visible to members rather than disappearing — read-only, with the reason where you would otherwise wonder.

Invite your team

From Members, create an invite with a role and, optionally, an email address. With an address, Peractor sends the join link for you; either way you get a copyable link to share yourself.

The invite page shows the organization and role, asks the visitor to sign in or create an account, and joins them in one click. An invited person who already has an account sees the invitation waiting in their own inbox. Pending invites can be revoked at any time.

Treat invite links like secrets. A link is redeemable by whoever holds it. The email address only controls where the link is delivered; it is not re-checked when the invite is accepted.

Switching organizations

Every surface has a switcher: the dashboard and desktop app in the sidebar header, the Mac in its sidebar, the editor in its account menu, and the phones in the drawer. Switching changes what every panel shows, and nothing is shared across organizations.

Ways to sign in

Email and password — eight characters minimum — or Continue with GitHub, Google, or Linear where the server has them configured.

The editor, the desktop app, and the Mac sign in through your browser and receive the session back over a local loopback, so you never type a password into them. The phones use the system browser sheet the same way.

Next: Plans & usage · Projects & repositories