Skip to main content

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.
The slug is permanent and cannot be changed after creation.

Team Roles

RoleCapabilities
OwnerFull control — manage settings, members, billing, GitHub integration. Transfer ownership or delete the team.
AdminManage team settings, invite/remove members, change member roles. Cannot transfer ownership or delete the team.
MemberAccess 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.
  • 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.

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

RoleCapabilities
AdminFull workspace control — manage settings, add/remove members, change roles.
EditorCreate and run tasks, collaborate on work within the workspace.
ViewerView the workspace, its tasks, and output. Read-only access.
Every workspace must have at least one admin. The last remaining admin cannot be removed or demoted.

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.
  • Voice participants — see who is in voice chat on 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

1

Open invitations

Open team settings or click Invite from the team page.
2

Enter email

Enter the person’s email address.
3

Set team role

Choose Member or Admin.
4

Select workspaces

Grant access to All Workspaces or select specific ones. For each workspace, pick a role (Admin, Editor, or Viewer).
5

Send

Click Send Invite. The link expires after 7 days.
If the email service is unavailable, the invite is still created. Copy the invite link from the success screen and share it directly.

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.
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.