e1d8ec91ea
- Added brand-new Usage Dashboard with deep analytics across all sessions 📊 - Overview tab shows totals, top agent, sources, and durations at-a-glance 🧾 - Activity heatmap reveals hourly/weekly usage patterns for smarter scheduling 🗓️ - Agent comparison charts help benchmark performance and response-time trends 🧪 - Dedicated Auto Run insights highlight automation time and completion rates 🤖 - Time-range filtering (today→all time) syncs across every dashboard view ⏱️ - One-click CSV export makes sharing and offline analysis effortless 📤 - New keyboard shortcut opens dashboard instantly: Opt+Cmd+U / Alt+Ctrl+U ⌨️ - Remote git worktree creation now supports SSH sessions via remote IDs 🔐 - Worktree sessions now inherit SSH config for smoother remote workflows 🧷
5.0 KiB
title, description, icon
| title | description | icon |
|---|---|---|
| Usage Dashboard | Track and analyze your AI agent usage patterns with comprehensive analytics and visualizations. | chart-line |
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:
- Click the hamburger menu (☰) in the top-left corner
- Select Usage Dashboard
From Quick Actions:
- Press
Cmd+K/Ctrl+Kand 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:
| Range | Description |
|---|---|
| Today | Current day only |
| This Week | Current week (default) |
| This Month | Current calendar month |
| This Year | Current calendar year |
| All Time | Everything since you started using Maestro |
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:
- Open Settings (
Cmd+,/Ctrl+,) - Find Stats Collection
- 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:
- Open Settings (
Cmd+,/Ctrl+,) - Enable Colorblind Mode
- 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