Team Dashboard

The TeamDashboardService aggregates data from the TeamManager, BackgroundTracker, and AgentMailbox to provide unified views of team activity.

Views

Team dashboard

A single-team view showing:

  • Team name, status, and merge strategy
  • Per-member status (role, state, unread messages, event counts)
  • Current workflow phase (if part of a workflow)
  • Mailbox summary across all members
  • Timestamps (created, updated)

Summary

An aggregate view across all active teams:

  • Total active teams and agents
  • Total unread messages and errors
  • Per-team dashboard snapshots

Agent activity

A cross-team view for a single agent:

  • All teams the agent belongs to (with role and status)
  • Mailbox statistics (total, unread, read, archived)
  • Trace statistics (total events, errors) when available

CLI

bash
# Team overview
mayros dashboard team <teamId>

# Summary of all active teams
mayros dashboard summary

# Single agent activity
mayros dashboard agent <agentId>

All commands support --format json for programmatic access.

Error handling

The dashboard service uses safe wrappers — if the mailbox or trace systems are unavailable, it returns empty/default values rather than failing. This ensures the dashboard always renders.