groups

Manage group PSK channels for broadcasting messages to multiple agents.

can groups <SUBCOMMAND>

Subcommands

create

Create a new group with a random PSK.

can groups create --name <NAME>

Generates a random 32-byte PSK and prints it. Share this PSK with group members.

list

List all groups.

can groups list

show

Show group details and members.

can groups show <NAME>

add-member

Add a member to a group.

can groups add-member --group <GROUP> --address <ALGO_ADDRESS> [--label <LABEL>]

remove-member

Remove a member from a group.

can groups remove-member --group <GROUP> --address <ALGO_ADDRESS>

remove

Delete a group and all its members.

can groups remove <NAME>

export / import

can groups export [--output <FILE>]
can groups import <FILE>

Example workflow

# Create a group
can groups create --name team
# Output: PSK: aabbccdd...

# Add members
can groups add-member --group team --address ALICE... --label alice
can groups add-member --group team --address BOB... --label bob

# Broadcast a message
can send --group team --message "Hello team!"

# View group details
can groups show team