Create a Session Group in One Step
/group <group name> (alias /g): automatically creates a new Lark group, invites you in, and transfers ownership to you, with the entire group serving as a single, independent CLI session (chat-scope). Great for spinning up a clean collaboration space dedicated to one project / task.
The bot replies with a card: "✅ Created group 'card race-condition bug' 👉
When the group name is empty, a timestamp is used as a fallback. After creation, no session is started automatically; enter the group and message the bot to start chatting.
Create a Group with Multiple Bots
Bots @-mentioned in the command are added into the new group together (the first @-mentioned bot is in charge of creating the group):
The reply lists "Bots in group: Claude, Codex". This makes the new group a natural multi-bot collaboration space — go in and @ whoever you want to do the work.
Bootstrap a Role Profile
If you keep reusable collaboration personas in a role profile, add --role-profile <profile> when creating the group:
After the group is created, the creator bot applies its own entry directly, then posts @Codex /role profile apply collab-main --quiet for the other bots inside the new group. Each bot applies only its own local profile entry, which materializes as that bot's this-group Role. Missing entries are safe and fall back to the default role.
Create a Group in the Dashboard
If you'd rather not use commands, the Groups panel in botmux dashboard can also create groups visually: pull specified bots into the group, automatically transfer ownership, and @-notify. The new-group dialog can select a Role Profile; an existing group's "Apply Profile" action opens Role Profiles with that group preselected as the Apply target. You can also disband a group / have a bot leave a group (associated sessions are cleaned up automatically). See Dashboard Control Panel.
"New Group": fill in the group name, bind a directory, and check the bots to pull into the group