> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whim.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams & Members

> Create teams, manage workspace members, and invite teammates.

## Teams

Teams are the top-level organizational unit in Whim. Every workspace belongs to a team, and team membership determines who can access the workspaces within it.

### Creating a Team

1. Click your team name in the sidebar and select **Create Team**.
2. Enter a **team name** — Whim generates a URL-friendly slug (e.g., "Acme Corp" → `acme-corp`).
3. Click **Create**. You become the team **owner**.

<Warning>
  The slug is permanent and cannot be changed after creation.
</Warning>

### Team Roles

| Role       | Capabilities                                                                                                    |
| ---------- | --------------------------------------------------------------------------------------------------------------- |
| **Owner**  | Full control — manage settings, members, billing, GitHub integration. Transfer ownership or delete the team.    |
| **Admin**  | Manage team settings, invite/remove members, change member roles. Cannot transfer ownership or delete the team. |
| **Member** | Access workspaces they've been added to. Cannot manage team settings or other members.                          |

There is always exactly one owner per team. Transfer ownership in team settings.

### Team Settings

Navigate to team settings by clicking your team name in the sidebar → **Settings**.

* **Team name** — update the display name at any time (admin or owner).
* **Team avatar** — upload an image (JPG, PNG, WebP, GIF, max 5 MB).
* **GitHub** — connect a GitHub organization to enable repository-linked workspaces. See [GitHub Integration](/integrations/github-skills-and-plugins#github-app-setup).

<AccordionGroup>
  <Accordion title="Danger zone (owner only)">
    - **Transfer Ownership** — select another member to become the new owner. You are demoted to admin.
    - **Delete Team** — permanently deletes the team and **all its workspaces**, including every task, container, and associated data. This is irreversible.
  </Accordion>
</AccordionGroup>

### Switching Teams

If you belong to multiple teams, use the team selector in the sidebar. Whim remembers your last active team.

***

## Workspace Members

Each workspace has its own member list with role-based access control. Workspace roles are separate from team roles — a team member might be an admin on one workspace and a viewer on another.

### Adding Members

Team admins and owners can add members to a workspace:

1. Open the workspace → **Settings → Members**.
2. Click **Add Member**.
3. Choose:
   * **Add from Team** — select an existing team member and assign a workspace role.
   * **Invite to Team** — invite a new user by email, adding them to both the team and workspace.
4. Select a role (defaults to **Editor**) and confirm.

### Workspace Roles

| Role       | Capabilities                                                                |
| ---------- | --------------------------------------------------------------------------- |
| **Admin**  | Full workspace control — manage settings, add/remove members, change roles. |
| **Editor** | Create and run tasks, collaborate on work within the workspace.             |
| **Viewer** | View the workspace, its tasks, and output. Read-only access.                |

<Warning>
  Every workspace must have at least one admin. The last remaining admin cannot be removed or demoted.
</Warning>

### Changing and Removing Roles

* **Change role**: Go to **Settings → Members**, click the role dropdown next to a member, and select the new role. Takes effect immediately.
* **Remove member**: Click **Remove** next to the member. This removes workspace access only — they remain on the team.

### Presence Indicators

Whim shows real-time presence so you know who's online:

* **Online status** — green indicator on a member's avatar when they're active.
* **Task viewers** — see who is currently viewing each task.

***

## Invitations

Invitations let team admins and owners bring new people into a team and grant workspace access in a single step.

### Sending an Invitation

<Steps>
  <Step title="Open invitations">
    Open team settings or click **Invite** from the team page.
  </Step>

  <Step title="Enter email">
    Enter the person's email address.
  </Step>

  <Step title="Set team role">
    Choose **Member** or **Admin**.
  </Step>

  <Step title="Select workspaces">
    Grant access to **All Workspaces** or select specific ones. For each workspace, pick a role (Admin, Editor, or Viewer).
  </Step>

  <Step title="Send">
    Click **Send Invite**. The link expires after **7 days**.
  </Step>
</Steps>

<Tip>
  If the email service is unavailable, the invite is still created. Copy the invite link from the success screen and share it directly.
</Tip>

### Accepting an Invitation

1. Click the join link in the invitation email.
2. Sign in or create a Whim account (the email must match the invitation).
3. You're automatically added to the team and all specified workspaces.

### Managing Pending Invitations

From team settings, admins and owners can view all outstanding invitations — including recipient, roles, workspaces, and expiry. Cancel any pending invitation at any time; the join link immediately stops working. Expired invitations are automatically cleaned up when a new invite is sent to the same email.

<Note>
  Invitations always operate at the team level — the invitee joins the team first, then receives workspace access. There is no way to invite someone to a workspace without adding them to the team. For existing team members, use **Add Member** in workspace settings instead.
</Note>