diff --git a/packages/kilo-docs/lib/nav/collaborate.ts b/packages/kilo-docs/lib/nav/collaborate.ts index 3ac1ded484..6774957194 100644 --- a/packages/kilo-docs/lib/nav/collaborate.ts +++ b/packages/kilo-docs/lib/nav/collaborate.ts @@ -53,6 +53,10 @@ export const CollaborateNav: NavSection[] = [ { title: "Enterprise", links: [ + { + href: "/collaborate/enterprise/sub-organizations", + children: "Sub-organizations", + }, { href: "/collaborate/enterprise/sso", children: "SSO" }, { href: "/collaborate/enterprise/model-access-controls", diff --git a/packages/kilo-docs/pages/collaborate/enterprise/sub-organizations.md b/packages/kilo-docs/pages/collaborate/enterprise/sub-organizations.md new file mode 100644 index 0000000000..399b6ccb09 --- /dev/null +++ b/packages/kilo-docs/pages/collaborate/enterprise/sub-organizations.md @@ -0,0 +1,105 @@ +--- +title: "Manage sub-organizations" +description: "Manage people, usage, credits, model policy, and permissions across enterprise sub-organizations" +--- + +# Manage sub-organizations + +{% callout type="info" %} +Sub-organization management is available to Enterprise organizations with a parent organization and direct sub-organizations. +{% /callout %} + +Sub-organizations let you separate teams, business units, or cost centers while managing them from one parent organization. Each sub-organization keeps its own members, credits, usage, and policies. + +The hierarchy has one level. A parent organization can have direct sub-organizations, but a sub-organization cannot contain another sub-organization. + +## Access sub-organization management + +1. Sign in to the [Kilo Web App](https://app.kilo.ai). +2. Open the parent organization. +3. Select **Sub-organizations** in the organization navigation, or select **Manage Sub-Organizations** from the Sub-organizations card on the organization overview. + +Only parent organization Owners, Admins, and Billing Managers can open the consolidated management area. Members of the parent organization and Owners of individual sub-organizations cannot use it to inspect other sub-organizations. + +{% image src="/docs/img/enterprise/sub-organizations-overview.webp" alt="Sub-organization management overview showing organization membership, seats, balances, and spend" width="100%" caption="Compare direct sub-organizations from the Overview section." /%} + +## Create a sub-organization + +Parent organization Owners and Admins can create direct sub-organizations. + +1. Open **Sub-organizations** from the parent organization. +2. Select **Overview**. +3. Select **Create sub-organization**. +4. Enter an organization name. +5. Select **Create sub-organization** to confirm. + +The new sub-organization starts empty. It does not automatically copy parent members, model policy, or organization settings. Parent Owners, Admins, and Billing Managers receive inherited management access without becoming members of the new sub-organization. + +{% callout type="note" %} +Billing Managers can view sub-organizations and manage financial operations, but they cannot create a sub-organization. +{% /callout %} + +{% image src="/docs/img/enterprise/create-sub-organization.webp" alt="Create sub-organization dialog with an organization name field" width="100%" caption="Create an empty direct sub-organization from the parent organization." /%} + +## Use the management sections + +The sub-organization area separates reporting and administrative tasks into focused sections. + +| Section | What it shows | +|---|---| +| **Overview** | Membership, seats, balances, and recent spend for each direct sub-organization. | +| **People** | One row per identity across the parent and its sub-organizations, including parent roles, accepted memberships, and pending invitations. | +| **Usage** | Requests, tokens, cost, and active users for a selected time range. | +| **Credits** | Credit balances, acquired and used credits, expirations, auto top-up status, Kilo Pass allocation, recent spend, and estimated runway. | +| **Distribute funds** | Transfer organization credits from the parent to one or more sub-organizations. | +| **Models** | Compare configured model, provider, group, automatic routing, and data-collection policy across organizations. | +| **Permissions** | Review ownership, roles, SSO policy, feature settings, daily spend limits, and inherited parent access. | + +### Find people across the hierarchy + +The **People** section combines each person into one record, even when that person belongs to multiple sub-organizations. Use it to: + +- Search by name or email. +- Filter by sub-organization, role, membership status, or assignment status. +- Sort by identity, parent role, or number of sub-organization memberships. +- Distinguish accepted memberships from pending invitations. +- Find parent members who are not assigned to a sub-organization. + +The People section reports current membership. To invite a new person, change a role, or remove a member, open the relevant organization's member settings. + +{% image src="/docs/img/enterprise/sub-organizations-people.webp" alt="Sub-organization People section with search, role, status, assignment, and organization filters" width="100%" caption="Search and filter people across the parent and its sub-organizations." /%} + +### Review usage and credits + +Use **Usage** to compare activity across sub-organizations for the same period. Filter the results by model or provider and switch between cost, requests, tokens, and active users. + +Use **Credits** to compare financial state across sub-organizations. Kilo Pass allocation represents pooled credit capacity for an organization, not passes assigned to individual people. If a future allocation differs from the current allocation, the table shows the transition separately. + +Use **Distribute funds** when you need to transfer credit balance. Kilo Pass capacity and credit balance are separate quantities and are managed separately. + +{% image src="/docs/img/enterprise/sub-organizations-credits.webp" alt="Sub-organization Credits section comparing balances, expirations, Kilo Pass allocation, spend, and runway" width="100%" caption="Compare credit state and Kilo Pass allocation across sub-organizations." /%} + +### Compare models and permissions + +The **Models** section compares the parent and each sub-organization. Parent and sub-organization policies are independent: changing the parent policy does not change or constrain a sub-organization policy. + +The section distinguishes configured restrictions from restrictions that are actively enforced by the organization's plan. Open an organization's own settings when you need to change its model policy. + +Use **Permissions** to identify sub-organizations without an independent Owner, review effective SSO policy, and see which parent users have inherited access. Inherited access does not create a membership or consume a seat in the sub-organization. + +{% image src="/docs/img/enterprise/sub-organizations-models.webp" alt="Sub-organization Models section comparing configured model and provider policies" width="100%" caption="Review independent model policy for the parent and each sub-organization." /%} + +## Recommended setup + +- Give every sub-organization at least one direct Owner. Inherited parent access does not replace independent ownership. +- Use names that identify a team, business unit, or cost center consistently. +- Review usage and credit runway regularly before distributing additional funds. +- Configure model and SSO policy for each organization intentionally; parent settings do not cascade automatically. +- Use the parent organization for shared oversight, not as a substitute for direct sub-organization membership. + +## Related documentation + +- [Model Access Controls](/docs/collaborate/enterprise/model-access-controls) +- [SSO](/docs/collaborate/enterprise/sso) +- [Audit Logs](/docs/collaborate/enterprise/audit-logs) +- [Team Management](/docs/collaborate/teams/team-management) diff --git a/packages/kilo-docs/pages/collaborate/index.md b/packages/kilo-docs/pages/collaborate/index.md index 22ff218be9..5d62434985 100644 --- a/packages/kilo-docs/pages/collaborate/index.md +++ b/packages/kilo-docs/pages/collaborate/index.md @@ -39,6 +39,7 @@ Kilo Code's paid plans provide powerful team management features: Enterprise features for large organizations: +- [**Sub-organizations**](/docs/collaborate/enterprise/sub-organizations) — Manage people, usage, credits, models, and permissions across business units - [**Audit Logs**](/docs/collaborate/enterprise/audit-logs) — Track and audit team activity - [**SSO**](/docs/collaborate/enterprise/sso) — Single sign-on with OIDC and SCIM - [**Model Access Controls**](/docs/collaborate/enterprise/model-access-controls) — Limit models and providers diff --git a/packages/kilo-docs/public/img/enterprise/create-sub-organization.webp b/packages/kilo-docs/public/img/enterprise/create-sub-organization.webp new file mode 100644 index 0000000000..d17bcbdd85 Binary files /dev/null and b/packages/kilo-docs/public/img/enterprise/create-sub-organization.webp differ diff --git a/packages/kilo-docs/public/img/enterprise/sub-organizations-credits.webp b/packages/kilo-docs/public/img/enterprise/sub-organizations-credits.webp new file mode 100644 index 0000000000..8ebca8e3c0 Binary files /dev/null and b/packages/kilo-docs/public/img/enterprise/sub-organizations-credits.webp differ diff --git a/packages/kilo-docs/public/img/enterprise/sub-organizations-models.webp b/packages/kilo-docs/public/img/enterprise/sub-organizations-models.webp new file mode 100644 index 0000000000..f1173b6b8b Binary files /dev/null and b/packages/kilo-docs/public/img/enterprise/sub-organizations-models.webp differ diff --git a/packages/kilo-docs/public/img/enterprise/sub-organizations-overview.webp b/packages/kilo-docs/public/img/enterprise/sub-organizations-overview.webp new file mode 100644 index 0000000000..10010cd4cd Binary files /dev/null and b/packages/kilo-docs/public/img/enterprise/sub-organizations-overview.webp differ diff --git a/packages/kilo-docs/public/img/enterprise/sub-organizations-people.webp b/packages/kilo-docs/public/img/enterprise/sub-organizations-people.webp new file mode 100644 index 0000000000..4ca542134b Binary files /dev/null and b/packages/kilo-docs/public/img/enterprise/sub-organizations-people.webp differ