Usage Dashboard

The Usage Dashboard provides comprehensive analytics for tracking your AI usage patterns across all sessions. View aggregated statistics, compare agent performance, and explore activity patterns over time.

​

Opening the Dashboard

Keyboard shortcut:

• macOS: Opt+Cmd+U
• Windows/Linux: Alt+Ctrl+U

From the menu:

1. Click the hamburger menu (☰) in the top-left corner
2. Select Usage Dashboard

From Quick Actions:

• Press Cmd+K / Ctrl+K and search for “Usage Dashboard”

​

Dashboard Tabs

The dashboard is organized into four tabs, each providing different insights into your usage:

​

Overview

The Overview tab gives you a high-level summary of your AI usage: Summary Cards:

• Total Queries — Number of messages sent to AI agents
• Total Time — Cumulative time spent waiting for AI responses
• Avg Duration — Average response time per query
• Top Agent — Your most-used AI agent
• Interactive % — Percentage of queries from interactive (non-Auto Run) sessions

Agent Comparison: A horizontal bar chart showing usage distribution across your AI agents. See at a glance which agents you use most, with query counts and time spent per agent. Source Distribution: A donut chart breaking down your queries by source:

• Interactive — Manual queries from AI Terminal conversations
• Auto Run — Automated queries from playbook execution

Toggle between Count (number of queries) and Duration (time spent) views. Activity Heatmap: A GitHub-style heatmap showing your activity patterns throughout the week. Each cell represents an hour of the day, with color intensity indicating activity level. Toggle between Count and Duration views to see different perspectives.

​

Agents

The Agents tab provides detailed per-agent analytics:

• Individual statistics for each AI agent
• Query counts, total time, and average duration per agent
• Comparison charts for side-by-side analysis

​

Activity

The Activity tab shows your usage patterns over time:

• Duration trends chart showing how your usage varies
• Time-based filtering to spot patterns
• Useful for understanding your productivity cycles

​

Auto Run

The Auto Run tab focuses specifically on automated playbook execution:

• Auto Run session statistics
• Task completion rates
• Time spent on automated vs. interactive work

​

Time Range Filtering

Use the time range dropdown in the top-right corner to filter all dashboard data: The selected time range applies to all tabs and charts. Your preferred time range is saved and restored between sessions.

​

Exporting Data

Click Export CSV in the top-right corner to download your usage data as a CSV file. The export includes:

• Query timestamps
• Agent information
• Duration metrics
• Source categorization (interactive vs. Auto Run)

Use exported data for further analysis in spreadsheet applications or to share usage reports.

​

Data Collection

​

What’s Tracked

The Usage Dashboard collects:

• Query events — Each message sent to an AI agent, including duration and which agent handled it
• Auto Run sessions — Start/end times of automated playbook runs
• Auto Run tasks — Individual task completions within playbooks

​

What’s NOT Tracked

• Message content (your prompts and AI responses)
• File contents or paths
• Token counts or costs (tracked separately per-session)
• Activity outside of Maestro

​

Enabling/Disabling Collection

Stats collection is enabled by default. To disable:

1. Open Settings (Cmd+, / Ctrl+,)
2. Find Stats Collection
3. Toggle off to stop collecting usage data

Disabling collection stops new data from being recorded but preserves existing data in the dashboard.

​

Accessibility

The Usage Dashboard supports colorblind-friendly palettes:

1. Open Settings (Cmd+, / Ctrl+,)
2. Enable Colorblind Mode
3. Charts will use high-contrast colors from the Wong palette

​

Tips

• Check the Activity Heatmap to understand your most productive hours
• Compare agents to see if one consistently performs faster than others
• Monitor Auto Run vs. Interactive ratio to understand your automation level
• Export regularly if you want to track long-term trends externally
• Use time filtering to focus on recent activity or see the big picture