---
title: "Org & Team Kit"
description: "Organizations, team settings, invites, allowed domains, roles, and app switching."
---
# Org & Team Kit
The Org & Team Kit standardizes how apps expose team membership and
organization context. It covers the team page, organization switcher, invites,
roles, allowed email domains, and the active organization that scopes sharing,
connections, service tokens, and app switching.
Team
8 members
Steve Ray steve@acme.com
Owner
Maya Chen maya@acme.com
Admin
Kai Wong kai@acme.com
Member
Anyone with an acme.com email can join
Pending invites
3
"
}
/>
## Pieces {#pieces}
| Piece | Purpose |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| `` | Standard team management page for members, invites, roles, and organization preferences. |
| `` | Current organization picker for sidebars and headers. |
| `` | One-click invite and domain-match join prompts. |
| `` | Guard for pages that need an active organization before rendering app data. |
| `useOrgRole()` | Shared role booleans for member, invite, settings, and domain controls. |
| Organization handlers | Create, rename, switch, invite, accept, remove, and update roles/domains. |
| Roles | Owner, admin, and member gates for sharing, settings, service tokens, and provider connections. |
| Allowed domains | Automatic join and domain-scoped access policy. |
| App links | Workspace app-link parsing and visible app-switcher helpers. |
## API {#api}
Render organization context wherever data scope changes. Put `OrgSwitcher` in
the persistent shell and make `/settings#team` or `/team` open `TeamPage`.
```tsx
import {
OrgSwitcher,
RequireActiveOrg,
TeamPage,
useOrgRole,
} from "@agent-native/core/client/org-team";
export function AppShell() {
return ;
}
export function SettingsTeamTab() {
return (
);
}
export function AdminOnlyControl() {
const { canManageOrg } = useOrgRole();
return canManageOrg ? : null;
}
```
Server code imports the same role helpers from `@agent-native/core/org-team`.
The route plugin mounts `/_agent-native/org/*` for org creation, switching,
invites, domains, member roles, and A2A secret sync.
## UX Standard {#ux-standard}
- Users can see which organization they are in before creating or sharing data.
- Invites and roles live in the team settings surface, not per-resource dialogs.
- Org domain changes are owner-only and explain who can auto-join.
- App switching lists workspace/default app links. Active-org continuity comes
from the target app sharing the same auth and organization state.
## What's next
- [**Multi-Tenancy**](/docs/multi-tenancy) — how org scoping isolates data
across tenants.
- [**Workspace Management**](/docs/workspace-management) — governance for
multi-app workspaces that share an organization.
- [**Sharing Kit**](/docs/toolkit-sharing) — the access model that roles and
org scope feed into.