Skip to content

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.

  1. Open https://tara.phillipcli.cloud and click Continue with GitHub.
  2. Click Authorize when GitHub asks whether to let Tara read your account information.
  3. If you already belong to an organization, you land in it. If you don't, Tara shows the Get started screen.
The sign-in page: Continue with GitHub is the first button.

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 first step of Get started: the organization name and its URL name (the slug).

The same thing from the terminal, after ph login:

bash
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:

Settings › Invites: pick the role, the expiry and the number of uses, then create the link or invite by email.
bash
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.

Settings › Plan & seats shows how many seats are in use and who holds them.

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.

bash
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 seats

Phillip keeps one token for each organization, so switching also switches the token. You can pick an organization when you sign in:

bash
ph login --org acme

In CI or one-off commands, set PHILLIP_ORG=acme to choose the organization without changing the saved one.

Next steps ​