CLI (wgl)

wgl (waggle) is the CLI for every Honeybee product. One tool for coordination, security scanning, cloud management, and local development.

Install

# Global install
npm install -g @honeybee-ai/waggle-cli

# Or run via npx
npx @honeybee-ai/waggle-cli <command>

Command groups

Coordination (ACP)

wgl init                    # Interactive setup
wgl join <url>              # Quick join a coordination server
wgl status                  # Show protocol, phase, claims
wgl leave                   # Release claims, disconnect
wgl team                    # Show connected agents
wgl protocol show           # Show protocol details
wgl protocol validate       # Validate a protocol YAML file

Events & State

wgl events list             # List events
wgl events tail             # Live-stream events
wgl events publish          # Publish an event
wgl state get [key]         # Get shared state
wgl state set <k> <v>       # Set shared state
wgl state delete <key>      # Delete state key

Communication

wgl msg send <to> <msg>     # Send a direct message
wgl msg list                # List messages
wgl msg broadcast <msg>     # Send to all agents
wgl help ask <problem>      # Request help
wgl help list               # Show open help requests
wgl help claim <id>         # Claim a help request
wgl help resolve <id>       # Resolve a help request

Control

wgl halt [reason]           # Emergency stop
wgl pause [reason]          # Pause coordination
wgl resume                  # Resume coordination

Resources

wgl claim <resource>        # Claim a resource (mutex)
wgl release <resource>      # Release a claim

Brood (Local Development)

wgl up                      # Start local brood from brood.yaml
wgl down                    # Stop running brood

Server

wgl serve                   # Start local incubator
wgl hooks install           # Install Claude Code hooks
wgl hooks uninstall         # Remove hooks
wgl hooks list              # Show installed hooks
wgl namespace list          # List namespaces
wgl namespace create        # Create namespace
wgl namespace delete        # Delete namespace

Platform (Authentication)

wgl auth login              # Device flow login
wgl auth logout             # Clear credentials
wgl auth status             # Show auth state
wgl auth switch             # Switch profiles
wgl config set <k> <v>      # Set preference
wgl config get <key>        # Get preference
wgl config list             # Show all preferences

Cloud (Colony + Marketplace)

wgl swarm create            # Create a managed hive
wgl swarm list              # List your hives
wgl swarm info              # Show hive details
wgl swarm delete            # Delete a hive
wgl swarm start             # Start a hive
wgl swarm stop              # Stop a hive
wgl swarm keys              # Manage API keys
wgl swarm logs              # Tail hive events
wgl secret set <provider>   # Set provider API key
wgl secret list             # List stored keys
wgl secret delete           # Delete a key
wgl marketplace search      # Search protocols
wgl marketplace install     # Install a protocol
wgl marketplace publish     # Publish a protocol
wgl integrations search     # Search integrations
wgl integrations install    # Install an integration

Telemetry

wgl telemetry overview      # Aggregate counters
wgl telemetry events        # Recent events
wgl telemetry timeline      # Daily breakdown

Tools

wgl scan <text>             # Scan for prompt injection
wgl completion <shell>      # Generate shell completions
wgl upgrade                 # Update to latest version

Product mapping

Commands	Product
init, join, status, team, leave	ACP (coordination)
protocol, events, state, claim, release	ACP (primitives)
msg, help	ACP (messaging)
halt, pause, resume	ACP (control)
up, down	Incubator (brood)
serve, hooks, namespace	Incubator (server)
auth, config	Hivemind (platform)
swarm, secret	Colony (managed)
marketplace, integrations	Marketplace
telemetry	Telemetry
scan	Carapace

Configuration

wgl reads configuration from multiple sources (highest precedence first):

1. CLI flags
2. Environment variables
3. Project .wglrc* (closest ancestor directory)
4. Global ~/.wglrc*
5. Defaults

Supported formats: .wglrc.yaml, .wglrc.json, .wglrc (key=value).

State lives in .honeyb/ (project) and ~/.honeyb/ (global).