Agent Task
Goal: Write a CLI tool that connects to a running WWA agent and displays its active handoff state — like htop for agent tasks.
Agent Instructions
agent: Claude Code, Codex, Cursor, Copilot, Generic MCP
goal: Create a handoff viewer CLI under reference/community/scripts/handoff-viewer/
inputs:
- handoff.md (spec)
- reference/agent/ (the reference agent implements /health)
outputs:
- handoff-viewer.py — CLI that:
- Takes --agent-url (default http://localhost:8787)
- Calls /health to get active_handoffs count + peer list
- Calls /iacp/message with a query handoff to see task state
- Displays a live-updating table (refreshes every 5s)
- Shows: handoff_id, task_id, sender, status, age
- README.md
- metadata.yaml
success_criteria:
- python handoff-viewer.py --agent-url http://localhost:8787
- Shows a table with at least handoff_id, status, age columns
- Updates every 5 seconds
- Graceful exit on Ctrl+CSee AGENTS.md.
Agent Task
Goal: Write a CLI tool that connects to a running WWA agent and displays its active handoff state — like
htopfor agent tasks.Agent Instructions
See AGENTS.md.