@honeybee-ai/waggle-cli 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# @honeybee-ai/waggle-cli
+
+Bridge AI agents to ACP coordination servers. `wgl` manages setup and installs Claude Code hooks that auto-claim files, check halt status, and inject protocol context during sessions.
+
+## Install
+
+```bash
+npm install -g @honeybee-ai/waggle-cli
+```
+
+## Quick Start
+
+```bash
+# Start an incubator server
+cd your-project && npx @honeybee-ai/incubator --http
+
+# In another terminal, join the coordination server
+wgl join http://localhost:3100 --role developer
+
+# Start Claude Code — hooks fire automatically
+claude
+
+# Check status anytime
+wgl status
+
+# When done
+wgl leave
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `wgl init` | Interactive setup — server URL, namespace, role |
+| `wgl join <url>` | Quick join — setup + connect + show team/protocol |
+| `wgl status` | Show protocol, phase, claims, events, control status |
+| `wgl leave` | Release claims, remove hooks, delete config |
+| `wgl protocol` | Show protocol details (phases, rules, resources) |
+| `wgl team` | Show connected agents and roles |
+| `wgl claim <resource>` | Claim a resource |
+| `wgl release <resource>` | Release a claimed resource |
+| `wgl halt [reason]` | Emergency stop all agents |
+| `wgl pause [reason]` | Pause coordination |
+| `wgl resume` | Resume coordination |
+
+## How It Works
+
+`wgl init` or `wgl join` creates a `.wgl.json` config file and installs Claude Code hooks into `.claude/settings.local.json`. The hooks run invisibly during Claude sessions:
+
+- **SessionStart** — exports env vars, checks control status, injects coordination context
+- **PreToolUse** (Edit/Write) — checks halt status, auto-claims files before edits
+- **PostToolUse** (Edit/Write) — publishes file change discoveries
+- **Stop** — checks for unread messages/help requests, releases claims
+- **UserPromptSubmit** — checks halt status, fetches new events
+
+All hooks degrade gracefully: if the server is unreachable or env vars are missing, they exit silently. Coordination is additive — it never blocks Claude unless intentional (halt, claim conflict).
+
+## Config
+
+`.wgl.json` in your project root:
+
+```json
+{
+  "server": "http://localhost:3100",
+  "namespace": "default",
+  "agentId": "wgl_a1b2c3d4",
+  "role": "developer",
+  "autoClaimFiles": true,
+  "autoPublishDiscoveries": true,
+  "hookTimeout": 10,
+  "lastEventCursor": 0
+}
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};