Swarm operations

Membership mutations require master authority. Commands operate on local swarm state; removal and revocation propagation should be checked on peers.

Inspect

gdc swarm status
gdc swarm members
gdc swarm tasks
gdc swarm tasks --workflow-id <id>

tasks queries the running orchestrator and requires master authority.

Remove a member

gdc swarm kick <agent-id> --reason "decommissioned"

Removes the member from the local registry.

Revoke a member

gdc swarm revoke <agent-id> --reason "key compromised"

Records revocation so subsequent signed messages from the identity are refused.

Hand off the coordinator

gdc swarm transfer-master <agent-id> --yes

Transfers master authority. After transfer, run on the new master:

gdc swarm revoke <previous-master-agent-id>

Dissolve the swarm

gdc swarm dissolve --yes --reason "project finished"

Writes the dissolved marker and clears the local member list.

Command summary

Command	Access	Effect
status	Local member	Role and member count
members	Local member	Membership list
tasks	Master	Tracked task list
kick	Master	Remove a member
revoke	Master	Revoke an identity
transfer-master	Master; --yes required	Transfer authority
dissolve	Master; --yes required	Dissolve local swarm

Select a swarm with --swarm-id or override its directory with --root.