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
- Click your team name in the sidebar and select Create Team.
- Enter a team name — Whim generates a URL-friendly slug (e.g., “Acme Corp” →
acme-corp). - Click Create. You become the team owner.
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. |
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.
Danger zone (owner only)
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.
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:- Open the workspace → Settings → Members.
- Click Add Member.
- 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.
- 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. |
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
Select workspaces
Grant access to All Workspaces or select specific ones. For each workspace, pick a role (Admin, Editor, or Viewer).
Accepting an Invitation
- Click the join link in the invitation email.
- Sign in or create a Whim account (the email must match the invitation).
- 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.

