Skip to main content

Multi-Organization Support

CICosts supports tracking costs across multiple GitHub organizations from a single account. Perfect for enterprises, agencies, and consultants managing multiple projects.

Overview​

With multi-org support, you can:

  • Track all organizations from one dashboard
  • Switch between orgs instantly
  • Compare costs across organizations
  • Set per-org budgets and alerts

Setting Up Multiple Organizations​

Add an Organization​

  1. Go to Dashboard
  2. Click the org switcher in the header
  3. Click "Add Organization"
  4. Select the organization from the list
  5. Complete the GitHub App installation
  6. Choose repository access

Repeat for each organization you want to track.

Organization Permissions​

You need to be an owner or admin of the organization to install CICosts. For organizations where you're just a member:

  1. Request installation from an admin
  2. Or ask the admin to install CICosts directly
  3. You'll see the org once it's connected

Using Multi-Org Features​

Org Switcher​

The org switcher in the dashboard header lets you:

  • Switch context - View one org at a time
  • See all orgs - View aggregated data across orgs
  • Quick search - Find orgs by name

Aggregated View​

When viewing "All Organizations":

  • Total cost across all orgs
  • Per-org breakdown in charts
  • Top workflows from any org
  • Recent runs from all orgs

Per-Org View​

When viewing a single organization:

  • Costs scoped to that org only
  • Workflows from that org only
  • Settings specific to that org
  • Alerts for that org

Use Cases​

Enterprise Teams​

Large companies with multiple GitHub organizations:

  • Track costs by division/team
  • Aggregate for company-wide reporting
  • Compare efficiency across teams
  • Allocate budgets per division

Example Setup:

Company Inc.
├── org: company-frontend (Web team)
├── org: company-backend (API team)
├── org: company-mobile (Mobile team)
└── org: company-infra (DevOps team)

Agencies​

Digital agencies managing client projects:

  • Track costs per client organization
  • Bill clients accurately based on usage
  • Identify clients exceeding estimates
  • Report to clients with real data

Example Setup:

Your Agency Account
├── org: client-a-inc
├── org: client-b-corp
├── org: client-c-llc
└── org: your-agency (internal)

Consultants​

Independent contractors working with multiple clients:

  • Separate billing per engagement
  • Track time-and-materials accurately
  • Demonstrate CI optimization value
  • Benchmark across clients

Cost Allocation​

Per-Org Reporting​

Export cost data per organization for billing:

  1. Select an organization
  2. Set the date range
  3. Click Export
  4. Use the CSV for client invoicing

Comparison Reports​

Compare costs across organizations:

OrganizationMonthly CostTrend
client-a$1,234+5%
client-b$2,567-12%
client-c$890+2%

Budget Tracking​

Set per-org budgets:

  1. Select an organization
  2. Go to Settings → Budget
  3. Set monthly limit
  4. Enable alerts

Alerts for Multiple Orgs​

Org-Specific Alerts​

Create alerts scoped to specific organizations:

  • "Alert if Client A exceeds $500/month"
  • "Alert if Client B has a 50% spike"

Global Alerts​

Create alerts across all organizations:

  • "Alert if total spend exceeds $5,000/month"
  • "Alert if any org spikes by 100%"

Permissions and Access​

What Each Org Can See​

When CICosts is installed on an organization:

  • Users in that org can see its costs
  • Other org's data is not visible
  • Only the installing user sees all orgs

Team Access (Team Plan)​

On the Team plan:

  • Add team members who can view all orgs
  • Set per-user permissions
  • Audit log of who accessed what

Privacy Between Orgs​

Organizations are isolated:

  • Client A can't see Client B's data
  • Users only see orgs they're members of
  • Aggregated views respect permissions

Best Practices​

Naming Conventions​

Use clear org names for easy identification:

  • Good: client-acme-corp, team-frontend
  • Bad: org1, test123

Regular Audits​

Periodically review connected organizations:

  • Remove orgs you no longer manage
  • Update permissions as team changes
  • Verify all repos are being tracked

Budget Buffers​

For client work, add buffer to budgets:

  • Set alerts at 80% of quoted amount
  • Review before reaching 100%
  • Renegotiate if needed

Next: Exports →