Frequently asked questions
These are the questions new users ask most often. If you're seeing a specific error message, see Troubleshooting.
Installation
What do I need to install to get started?
Devs and Testers need Node 22 or later, git, and Phillip, which you install from Tara with one command. BAs, POs, and PMs need only a browser. See Dev and Test and Get started for BAs, POs, and PMs.
I installed it, but ph says command not found. Why?
npm's global bin directory isn't in your PATH yet. Open a new terminal. If it still fails, add $(npm prefix -g)/bin to PATH. In the meantime, you can type phillip instead of ph. See Detailed installation.
Do I have to use sudo to install?
No. The install script doesn't use sudo. If you get an EACCES error, set the npm prefix to a directory of your own as described in Detailed installation. Guardrails is the exception: it's installed with administrator rights.
How do I update Phillip?
Run the same install command again. The script fetches the latest version from Tara, verifies the sha256, installs over the old version, and keeps your configuration.
Accounts
Which account do I use to sign in to Tara?
Use GitHub today. GitLab and SSO appear when your organization sets them up. Signing in only proves who you are. It doesn't put you in any organization, so a new account lands on a Get started screen where you create an organization or accept an invitation. Tara doesn't store passwords. The Bandum web app signs in through Tara, so it has no separate password either.
I can sign in but I don't see any projects. Why?
The Projects section shows only the projects of the organization you have open. Check the organization switcher at the top of the Portal, because you may be in several. If you belong to none yet, you see the Get started screen. If the organization is the right one, ask an Owner or Admin whether the project exists yet. Members can create one with ph project create <key>.
Organizations and seats
What is an organization?
It's your company or team's space in PhillipCLI. It holds your members, projects, private resource store, guardrails, and metrics, and nothing in it is visible to other organizations. Inside an organization, work is grouped into projects. See Roles and permissions.
How do I join an organization?
Ask an Owner or Admin to invite you. You get an invitation by email or as a link: open it, sign in, and you're in. In the Portal, Owners and Admins use the organization's members page. With Phillip, they run ph org invite <email> --role member, or ph org invite --link for a link. If you don't have an invitation, you can create your own organization from the Get started screen or with ph org create <slug>.
Can I belong to several organizations?
Yes, like on GitHub. You have one role in each. The organization switcher at the top of the Portal changes the one you're looking at, and ph org list and ph org switch <slug> do the same in the terminal. A login and a token belong to one organization, so after you switch, Phillip uses the token for that organization.
What are seats? How many do I get?
Owners, Admins, and Members use a seat. Viewers don't, and they're free. The Free plan has 7 seats. The Team plan has no seat limit and costs $3 per AI user per month or $30 per year, billed for a minimum of 8; see Pricing and Billing and upgrading. When all seats are taken, inviting or joining another Owner, Admin, or Member is refused with seat_limit. See Troubleshooting. ph org current shows your plan and seats.
Who is a Viewer?
A Viewer works in the browser only: they see tasks, approve work on Bandum web, and read dashboards. That's the right role for BAs, POs, and PMs. A Viewer can't run agents or install resources.
Do I type skill-review or acme/skill-review?
A full name is <owner>/<name>, such as acme/skill-review or an/skill-notes. A bare name like skill-review means aiforge/skill-review first, then a resource of your current organization, then one in your own personal store. It never matches a resource of another person or organization, so nobody can take over a bare name by publishing a public resource. To use a resource from someone else, type its full name. See Resources.
Why didn't my bare name resolve?
A bare name only looks in aiforge/, your current organization, and your own personal store. If the resource belongs to someone else, or to an organization you haven't opened, Tara answers 404 and, when a public resource with that name exists, adds a hint such as did you mean beta/skill-foo?. Use the full name from the hint. If it is your own personal resource and it still fails, check that you are signed in as the owner (ph tara whoami prints your namespace).
What is my personal store?
Every account has one. A resource you publish with ph tara publish goes there by default, as <your-handle>/<name>, and only you can see and install it, in every organization you belong to. It is the place to try something out. Scripts, hooks, and MCP servers are allowed there, but a public resource can't contain them.
How do I share a resource with my team?
Contribute it: ph tara contribute <name> --org <slug> copies the resource to <org>/<name>, records who contributed it and where it came from, and releases it at once for every member of the organization. There is no review step. You can also publish straight into the organization with ph tara publish --org <slug>. Organization resources are internal by default.
Who can publish to my organization?
Owners and Admins always can, and Members can by default. An Owner or Admin can change this in Settings, then General, under Who can publish to this organization: Members and admins or Admins only. Viewers never publish to the organization, but they can still use their personal store. The change is written to the audit log.
Can I make a resource public?
Yes, with ph tara visibility <name> public, or on the resource page. A personal resource is made public by its owner, an organization resource by an Owner or Admin. Community rules apply: no executable components, a malware and secret scan, and a model review. Tara tells you what to fix if it refuses. Public resources carry the Community label, and anyone can install them by full name.
Can an organization and a person share a name?
No. People and organizations share one namespace. Tara refuses to create an organization whose slug equals a user handle, and a new user whose handle equals an organization slug gets a suffix, for example an-2.
Who is platform staff?
A small PhillipCLI team that runs the service and reviews the official store (aiforge/<name>). It's an internal flag on their PhillipCLI accounts, not a role you can be given in your organization. Your organization's own resources have no review: a version that passes the automated scanner is released at once.
What do I do when my session expires?
Run ph login to sign in again (--org <slug> picks the organization), and ph tara whoami to see your account and session expiry. On a machine with no browser, such as over SSH or in CI, use ph tara login --token-stdin with a personal token.
What is the banner at the top of the Portal?
An announcement from PhillipCLI: planned maintenance, an incident, or news. It is aimed at your organization (everyone, one plan, or named organizations) and shows an icon and a label (Info, Warning or Critical). Some can be dismissed with the X, and a dismissed announcement stays hidden for you only. Announcements that need your attention can also be emailed to organization owners.
Do I see announcements in the CLI?
Yes. ph tara announcements lists the active announcements of your current organization. Other ph tara ... commands print an active warning or critical announcement once a day (to stderr, so scripts and --json output are not affected). Set PHILLIP_NO_ANNOUNCEMENTS=1 to turn that off.
I got an email that PhillipCLI support viewed my account. What happened?
A support engineer opened a read-only view of your account or organization, for up to 30 minutes, to help with a request. Nothing can be changed during a view: every action that writes is refused. You and the organization owners are emailed when a view starts, and it appears in the organization audit log without the engineer's name.
Tasks and testing
What does GH-12 mean? Does it work on GitLab?
It's the issue number. On GitLab, you still use the GH- prefix with the issue number in the project.
Why can't I click Approve?
Approve is enabled only when every test case you marked is Pass. If a test case is still unmarked, or a test case is Fail without a bug description, the button isn't available yet. When a test case fails, click Send back. The person who opened the PR also can't approve their own PR.
How do I report a bug that's in the task I'm testing?
Mark the related test case Fail and describe the bug. Don't create a new issue. Only bugs outside the task's scope need a type: bug issue. See Report bugs.
What do I do when a task is returned?
Run ph bandum pull GH-12 to read the comments and ph bandum fix GH-12 to have the agent fix it. Then run ph bandum verify and ph bandum review to move it back to testing. See The life of a task.
Why does ph bandum review refuse to move the task to testing?
Usually an AC has no test case, or testcases.md still has an entry you haven't filled in (<fill in the name>). Run ph bandum check to see each error. Every AC of the task must have at least one test case.
Data and privacy
Is my source code sent to Tara?
No. Phillip and Bandum run on your machine, so your source code stays on your machine. Tara and Ryoma run online and receive only usage metrics, not source code. Details are in Data collected.
Are my metrics used to evaluate me as an individual?
No. The Flow and AI metrics belong to the project and the flow of work. Per-person metrics are visible only to that person, and Owners and Admins also see usage and quota to manage them. Members and Viewers don't see other people's metrics. See Who can see what.
What do I do when Guardrails blocks a reasonable action?
Read the reason in the message and ask the agent to take another approach. If you think the block was a false positive, send ph guardrails feedback <rule id> --note "...". See When Guardrails blocks you.