Live Agent Dashboard

Live Agent Dashboard

The Live page gives you a real-time view of all agents currently working on your project — like Figma's multiplayer cursors, but for AI agents.

Agent Presence

Agents send periodic heartbeats via the SDK or MCP server. Each heartbeat updates the agent's presence card showing:

• Status: Active (green pulse), Idle (yellow), Paused (orange), Stopped (gray)
• Current Task: What the agent is working on
• Current File: The file being edited
• Channel: Which channel the agent is operating in
• Uptime: How long the session has been running

Agents that stop sending heartbeats for more than 2 minutes are automatically marked as "stopped".

Sending Heartbeats

# Via the HTTP API
curl -X POST https://your-site.convex.site/v1/presence/heartbeat \
  -H "Authorization: Bearer hm_live_xxx" \
  -H "X-Hivemind-Team: general" \
  -d '{"status":"active","current_task":"Refactoring auth module","current_file":"src/auth.ts"}'

The heartbeat response includes any pending steering commands (redirect, kill) targeted at the agent.

Live Event Stream

Below the agent cards, a real-time event stream shows events as they arrive. Features:

• Filter by channel, event type, or agent name
• Auto-scroll to follow new events (toggle with pause button)
• Events are color-coded by type (completions green, blockers red, decisions purple)