Skip to main content
Director’s Notes is your bird’s-eye view of everything happening across all your AI agents. Instead of switching between tabs to check what each agent has been doing, Director’s Notes aggregates all history entries into a single, searchable, filterable timeline - and can generate an AI-powered synopsis of recent activity.
Director’s Notes is an Encore Feature - it’s disabled by default. Enable it in Settings > Encore Features to access the shortcut, menu entry, and command palette action.
Encore Features settings panel

​
Opening Director’s Notes

Keyboard shortcut:
  • macOS: Cmd+Shift+O
  • Windows/Linux: Ctrl+Shift+O
From Quick Actions:
  • Press Cmd+K / Ctrl+K and search for “Director’s Notes”

​
Tabs

Director’s Notes has three tabs:

​
Unified History

The primary view - a chronological list of all history entries from every agent, newest first. Director's Notes Unified History Filtering:
  • AUTO / USER toggle buttons filter by entry type
  • Search (Cmd+F / Ctrl+F) filters by summary text or agent name
  • Activity Graph shows entry distribution over time; right-click to change the lookback window (24 hours through all time)
Stats Bar: A centered aggregate stats bar displays key metrics across the current dataset:
  • Total queries, sessions, AUTO entries, USER entries, and total cost
Entry Details: Each entry shows:
  • Agent name - which Maestro agent produced the entry
  • Task name pill - clickable link to the originating session
  • Type badge (AUTO or USER)
  • Summary of what was accomplished
  • Duration and cost (when available)
  • Timestamp
Click any entry to open the Detail Modal with full response text, token breakdown, and navigation controls (Prev/Next or arrow keys). Session Navigation: Click the session pill on any entry to jump directly to that agent’s tab - Director’s Notes closes and focuses the agent with the relevant session loaded. Infinite Scroll: Entries load progressively (100 at a time). Scroll to load more as needed.

​
AI Overview

An AI-generated synopsis of recent activity across all agents. This tab uses a configurable AI provider to read history files and produce a structured report. Director's Notes AI Overview Controls:
  • Lookback slider - Adjust from 1 to 90 days to control the analysis window
  • Rich / Plain toggle - Switch between the Rich dashboard and the Plain markdown view (see Reading modes below)
  • Refresh - Regenerate the synopsis with current settings
  • Save - Export the synopsis as a markdown file
  • Copy - Copy the synopsis to the clipboard as readable markdown
Stats Bar: After generation, a stats bar shows:
  • Number of history entries analyzed
  • Number of agents with activity
  • Generation time
Synopsis Content: The AI produces a structured report organized by agent/project with sections for:
  • Accomplishments - What was completed
  • Challenges - Issues encountered or unresolved
  • Next Steps - Recommended follow-up actions

​
Reading modes: Rich and Plain

The AI Overview renders the same synopsis two ways, switchable with the Rich / Plain toggle:
  • Rich (default) is a dashboard. Deterministic widgets - stat cards, an activity timeline, success/failure and source breakdowns, and per-agent activity - are computed directly from your history (never inferred by the AI), and the Accomplishments / Challenges / Next Steps narrative renders as styled section cards beneath them.
  • Plain is the classic reading view: the narrative as a clean markdown document, with no widgets.
Copy and Save always export the Plain markdown regardless of the mode you’re viewing, so a copied or saved synopsis is the readable report - not the dashboard’s underlying data. You can set which mode opens by default in Settings > Encore Features > Director’s Notes; the in-tab toggle overrides it for the current session. Provider Configuration: Configure which AI provider generates the synopsis in Settings > Encore Features. Any installed agent (Claude Code, Codex, OpenCode) can be used. The default lookback window is also configurable there.
The AI Overview tab becomes available once the synopsis has finished generating. A spinning indicator on the tab shows generation is in progress. Results are cached for the session - switching tabs won’t trigger a regeneration.

​
Help

A built-in reference guide explaining all Director’s Notes features, entry types, keyboard shortcuts, and workflows.

​
Keyboard Shortcuts

​
Unified History

​
Detail View

​
Settings

Access Director’s Notes settings via Settings > Encore Features (enable Director’s Notes first):

​
Tips

  • Use AI Overview after an Auto Run session to get a quick summary of everything that was accomplished across all agents
  • Search by agent name in Unified History to isolate work from a specific project
  • Right-click the activity graph to quickly change the time window without scrolling
  • Save or copy the synopsis to include in standup notes, PRs, or project documentation
  • Session navigation lets you jump directly from a history entry to the agent that produced it - great for resuming or reviewing work

​
Pulling Notes from the CLI

The same unified history and AI synopsis are available from maestro-cli, so you can pipe Director’s Notes into shell scripts, cron jobs, or your own reporting tools without opening the app.

​
Generating a weekly report

Combine synopsis with a redirect (or your favorite scheduler) to produce a self-serve weekly report:
Schedule it with cron, launchd, or Maestro Cue on a weekly interval to wake up to a fresh status report every Monday. Pair it with maestro-cli notify toast --open-file <path> if you want a clickable in-app reminder when the report lands.
history reads directly from disk and works offline. synopsis needs the Maestro desktop app running because it dispatches the prompt through your configured AI provider.