Create or join an organization
Everything in PhillipCLI belongs to an organization: members, projects, your private resource store, and the seat count. Signing in only tells Tara who you are. After that, you either create an organization or join one that invited you. This page takes about 5 minutes.
Sign in for the first time
Anyone with a GitHub account can sign in. Tara no longer checks which GitHub organization you belong to.
- Open
https://tara.phillipcli.cloudand click Continue with GitHub. - Click Authorize when GitHub asks whether to let Tara read your account information.
- If you already belong to an organization, you land in it. If you don't, Tara shows the Get started screen.
You can also sign in with Google or an email link, and an organization can let people join with a verified email domain or through its GitHub organization. See Sign-in options.
Create an organization
On the Get started screen, fill in Create an organization: the Organization name and the URL (the slug). The slug is the short name in your URLs (https://tara.phillipcli.cloud/acme) and in resource names (acme/skill-review). It can't be changed later. You become the Owner, and the organization starts on the Free plan.
The same thing from the terminal, after ph login:
ph org create acme --name "Acme Corp"Tara then suggests the next steps: invite teammates, create your first project, and install Phillip. For the project, open Settings, then Projects, then New project, or run ph project create shop-web.
Join an organization
There are two ways in today.
- Invitation by email. An Owner or Admin invites your address. Sign in with GitHub, and Tara adds you to the organization. Only the holder of that address can accept the invitation.
- Invitation link. An Owner or Admin sends you a link. Open it, sign in, and you're in. A link has a role, an expiry date, and a number of uses.
If you have no invitation yet, use the I was invited box on the Get started screen. Paste the link or code into Invitation link or code, or ask an Admin of your organization to invite you.
Owners and Admins create invitations in the Portal under Settings, then Invites, or with commands:
ph org invite dev@example.com --role member
ph org invite --link --role viewer --max-uses 20 --expires 7d
ph org invites # list invitations
ph org invites revoke <id>Choose the role by what the person does. Member is for people who use Phillip and agents. Viewer is for BAs, POs, and PMs who work only in the browser, and it takes no seat. See Roles and permissions.
Seats
The Free plan has 7 seats. Owners, Admins, and Members each take a seat. Viewers are free. If an invitation or a role change would go over the limit, Tara refuses it with the seat_limit error. Ask your Owner to free a seat (remove someone or change them to Viewer), or upgrade to the Team plan (how). See Troubleshooting.
Switch between organizations
One account can belong to many organizations. In the Portal, use the organization switcher in the top corner. The URL changes to the organization's slug, so you can share a link to a page. If you open an organization you don't belong to, Tara answers with a 404 on purpose.
ph org list # your organizations; the current one is marked *
ph org switch acme # use another organization
ph org current # current organization, your role, plan and seatsPhillip keeps one token for each organization, so switching also switches the token. You can pick an organization when you sign in:
ph login --org acmeIn CI or one-off commands, set PHILLIP_ORG=acme to choose the organization without changing the saved one.