Waggle
An async task coordination protocol for autonomous AI agents.
Inspired by the honeybee waggle dance — nature's original decentralized coordination protocol.
A bee returns to the hive and tells others where to work. No central controller needed.
What is Waggle?
Waggle is a Claude Code plugin that lets each team member's AI agent share a single task board. Agents pick up work, execute autonomously, and hand off results — across devices, sessions, and environments.
A human creates a task on their laptop. Another member's agent on Claude Desktop picks it up. A third agent running in Cowork executes it overnight. The board is the only shared state.
How it differs
AI agents today have several ways to collaborate. Waggle occupies a distinct space:
Agent Teams lets multiple Claude instances work together in real time within a single session. When the session ends, the collaboration ends. It excels at synchronous, tightly-coupled work like brainstorming or co-authoring code.
Agent Memory tools (Mem0, Claude-Mem, Engram, etc.) persist knowledge and context across sessions. They help an individual agent remember — but they don't coordinate work across a team.
Waggle coordinates work across team members and their agents. Tasks flow through a state machine, get delegated between members, and are executed autonomously on different devices. It persists not knowledge, but work itself — who needs to do what, what's blocked, and what's done.
| Agent Teams | Agent Memory | Waggle |
|---|
| Purpose | Real-time collaboration | Cross-session recall | Team task coordination |
| Scope | Single session | Single agent | Multiple members and agents |
| Persistence | Ephemeral | Knowledge / context | Task lifecycle and state |
| Coordination | Synchronous | None | Asynchronous, cross-device |
These are complementary. Use Agent Teams for real-time collaboration within a session, Agent Memory to retain context, and Waggle to track and dispatch work across your team.
Quick Start
Prerequisites
Install
Add the marketplace and install:
/plugin marketplace add kazukinagata/waggle
/plugin install waggle@kazukinagata-waggle
Or browse interactively — run /plugin, go to Discover, and select waggle.
Setup
/setting-up-tasks
Choose your provider:
- SQLite — instant local setup, zero external dependencies
- Notion — team collaboration via Notion workspace
- Turso — remote SQLite for multi-agent sync (requires Turso account)
Use
"add a task to research competitor pricing"
"what's next?"
"execute tasks"
"show kanban"
"delegate API task to Alice"
The Protocol
Waggle defines 15 core fields and 9 extended fields with a 6-state machine that any backend can implement. If your storage supports these fields and transitions, it's a Waggle-compatible task board.
Backlog → Ready → In Progress → In Review → Done
↓
Blocked
See skills/waggle-protocol/ for the full specification.
Providers
| Provider | Use Case | Status |
|---|
| SQLite | Local, instant, zero-setup | Available |
| Notion | Team collaboration via Notion workspace | Available |
| Turso | Remote SQLite, multi-agent sync | Available |
The provider abstraction means you can add your own backend. See skills/provider-contract/ for the interface contract.
Features
- Natural Language CRUD — create, update, query, and delete tasks by talking to Claude
- Real-time Views — Kanban, List, Calendar, and Gantt views at
http://localhost:3456
- Autonomous Execution — dispatch tasks to parallel tmux sessions or Scheduled Tasks
- Task Planning — generate Acceptance Criteria and Execution Plans with brainstorming agents
- Task Monitoring — health checks on stagnation, field quality, blocked tasks, and executor ratio
- Task Delegation — hand off tasks to other team members
- Custom Views — create user-defined HTML visualizations beyond the built-in views
- Pre-creation Checklist — validation gate ensures task quality before creation
- Message Intake — auto-convert Slack/Teams/Discord DMs into categorized tasks
- Daily Routine — unified message intake + task refinement + dispatch
Architecture
kazukinagata