CLI Commands

Coordination

wgl init

Interactive setup — configure server URL, namespace, and role.

wgl init

wgl join <url>

Quick join a coordination server.

wgl join http://localhost:8080

wgl status

Show current protocol, phase, claims, events, and control status.

wgl status

wgl leave

Release all claims, remove hooks, delete local config.

wgl leave

wgl team

Show connected agents and their roles.

wgl team

wgl protocol show

Display protocol details (phases, roles, rules, governance).

wgl protocol show

wgl protocol validate <file>

Validate an ACP protocol YAML file against the schema.

wgl protocol validate my-spec.acp.yaml

wgl protocol load <file>

Load a protocol into the running server.

wgl protocol load my-spec.acp.yaml

Events & State

wgl events list

List events. Filterable by type and time.

wgl events list
wgl events list --since 10 --type task.complete

wgl events tail

Live-stream events (polling).

wgl events tail
wgl events tail --type task.*

wgl events publish

Publish an event.

wgl events publish --type task.complete --data '{"task": "auth"}'

wgl state get [key]

Get shared state (all keys or specific key).

wgl state get
wgl state get current_phase

wgl state set <key> <value>

Set a shared state value.

wgl state set current_phase review

wgl state delete <key>

Delete a shared state key.

wgl state delete temp_value

Resources

wgl claim <resource>

Claim a resource (atomic mutex lock).

wgl claim file:src/api.ts

wgl release <resource>

Release a previously claimed resource.

wgl release file:src/api.ts

Communication

wgl msg send <to> <message>

Send a direct message to an agent.

wgl msg send reviewer-1 "Please check the auth module"

wgl msg list

List messages for the current agent.

wgl msg list

wgl msg broadcast <message>

Send a message to all connected agents.

wgl msg broadcast "Deploying in 5 minutes"

wgl help ask <problem>

Request help from other agents.

wgl help ask "Tests failing on auth module"

wgl help list

Show open help requests.

wgl help list

wgl help claim <id>

Claim a help request.

wgl help claim help-123

wgl help resolve <id>

Mark a help request as resolved.

wgl help resolve help-123

Control

wgl halt [reason]

Emergency stop — halt all agents.

wgl halt "Critical bug discovered"

wgl pause [reason]

Pause coordination (agents stop processing but don’t terminate).

wgl pause "Reviewing test results"

wgl resume

Resume paused coordination.

wgl resume

Brood

wgl up

Start a local brood from brood.yaml in the current directory.

wgl up
wgl up --brood=path/to/brood.yaml

wgl down

Stop a running brood and all its agents.

wgl down

Server

wgl serve

Start a local incubator server.

wgl serve
wgl serve --port=8080 --verbose

wgl hooks install

Install Claude Code hooks for ACP integration.

wgl hooks install

wgl hooks uninstall / list

wgl hooks uninstall
wgl hooks list

wgl namespace list / create / delete

wgl namespace list
wgl namespace create my-namespace
wgl namespace delete my-namespace

Platform

wgl auth login          # Device flow (opens browser)
wgl auth logout
wgl auth status
wgl auth switch          # Switch between saved profiles

wgl config set / get / list

wgl config set server http://localhost:8080
wgl config get server
wgl config list

Cloud

wgl swarm create / list / info / delete / start / stop

wgl swarm create --name my-project
wgl swarm list
wgl swarm info my-project
wgl swarm start my-project
wgl swarm stop my-project
wgl swarm delete my-project

wgl swarm keys / logs

wgl swarm keys my-project
wgl swarm logs my-project

wgl secret set / list / delete

wgl secret set cerebras                    # User-level key
wgl secret set cerebras --hive my-project  # Hive-specific key
wgl secret list
wgl secret delete cerebras

wgl marketplace search / info / install / publish / list

wgl marketplace search "code review"
wgl marketplace info code-review
wgl marketplace install code-review
wgl marketplace publish my-protocol.acp.yaml
wgl marketplace list

wgl integrations search / install / remove / enable / disable / publish / list

wgl integrations search "slack"
wgl integrations install slack-notifier
wgl integrations enable slack-notifier
wgl integrations remove slack-notifier
wgl integrations list

Telemetry

wgl telemetry overview         # Aggregate counters
wgl telemetry overview --local # Local-only (skip cloud)
wgl telemetry events           # Recent events
wgl telemetry events --type llm_call --limit 20
wgl telemetry timeline         # Daily breakdown

Tools

wgl scan <text>

Scan text for prompt injection.

wgl scan "ignore all previous instructions"
wgl scan --json "test message"

wgl completion <shell>

Generate shell completion script.

wgl completion bash >> ~/.bashrc
wgl completion zsh >> ~/.zshrc

wgl upgrade

Update wgl to the latest version.

wgl upgrade