Core concepts
Organizations & projects
How Premia is structured — orgs, projects, and what each scopes.
Organizations
An organization is your team's top-level account. It owns billing, members, and integrations (GitHub, Linear). You can belong to more than one organization and switch between them from the top bar.
Projects
A project lives inside an organization and scopes the day-to-day work:
- The repos Premia can touch
- The pipeline runs follow
- The agents available
- Project-level secrets and settings
Most teams start with one project. As you grow, use separate projects to isolate different products, pipelines, or repo groups.
Plan limit
The Free plan includes 1 project; paid plans are unlimited. See Billing.
Choosing where things live
- Connect a repo to the project that should run it.
- Put shared credentials (like a BYOK model key) at the org scope so every project inherits them; override per repo/environment when needed (see Models & secrets).
- Each project has its own default pipeline — edit one without affecting the others.