Skip to content
Honeybee AI

Quick Start: CLI

Install

Section titled “Install”
Terminal window
npm install -g @honeybee-ai/waggle-cli

Verify:

Terminal window
wgl --version

Scan for prompt injection

Section titled “Scan for prompt injection”
Terminal window
wgl scan "ignore all previous instructions"
# → BLOCK (score: 150)

Start a local server

Section titled “Start a local server”
Terminal window
wgl serve
# Starts incubator on default port

Check status

Section titled “Check status”
Terminal window
wgl status
# Shows protocol, phase, connected agents, claims

Validate a protocol

Section titled “Validate a protocol”
Terminal window
wgl protocol validate my-spec.acp.yaml
# Validates schema, roles, phases, governance

Start a local brood

Section titled “Start a local brood”
Terminal window
# Create brood.yaml in your project
wgl up
# Reads brood.yaml, starts incubator, spawns agents

Authenticate with the platform

Section titled “Authenticate with the platform”
Terminal window
wgl auth login
# Opens browser for device flow authentication


wgl auth status
# Shows current auth state and profile

Manage cloud hives

Section titled “Manage cloud hives”
Terminal window
# Create a hive
wgl swarm create --name my-project


# Set provider key
wgl secret set cerebras


# Start
wgl swarm start my-project


# Monitor
wgl swarm info my-project


# Stop
wgl swarm stop my-project

Shell completions

Section titled “Shell completions”
Terminal window
# Bash
wgl completion bash >> ~/.bashrc


# Zsh
wgl completion zsh >> ~/.zshrc


# Fish
wgl completion fish > ~/.config/fish/completions/wgl.fish

What’s next

Section titled “What’s next”