Maestro Files

🪄 Maestro Cue is a new trigger-based cross-agent orchestration capability. Heartbeats, GitHub issues/PRs, file system monitors, and other data sources can bring your agents to life and pass work between one another.

💻 Major Shell Upgrade — Full-featured xterm.js terminal tabs alongside your existing AI and file preview tabs. Open multiple terminals and rename them freely.

🌐 Web UX Parity — The web/mobile interface now supports real PTY terminals, swipeable panels, notification dropdowns, and dozens of desktop-equivalent features. Full touch-friendly experience on tablets and phones.

🔗 SSH Shared History — History synchronization across multiple Maestro instances working on the same project via SSH. Each host writes per-hostname JSONL files to .maestro/history/ on the remote, so all participants see each other's work.

Changes in v0.16.6-RC

New Features

• Environment variables tab: Dedicated Environment tab in Settings for managing global environment variables passed to all agents
• Cross-host shared history: SSH remote agents sync history entries to a shared .maestro/history/ directory on the remote host, with per-hostname attribution and "Remote" pill indicators in the UI. Toggle via "Sync history to remote" in SSH settings
• Web terminal PTY support: Web/mobile terminal sessions now get real PTY backends with full resize support
• Swipeable panels on tablet: Left-edge swipe opens the agent panel; right-edge swipe opens the right panel. Both support swipe-to-close
• Notifications dropdown: Bell icon in web header shows completed/errored agents with direct switch-to-agent on click
• Auto Run play button removed: Auto Run is now accessible exclusively via the Right Panel tab and Cmd+K, decluttering the header

Bug Fixes

• Codex v0.111.0 support: Live terminal rendering and history for the new Codex JSON format. Tool call messages now merge correctly instead of creating duplicates
• Custom notification synopsis: TTS and custom notifications now receive the task synopsis for user-initiated tasks
• Cloudflare tunnel restart: Tunnel now automatically restarts when the web server port changes, instead of requiring a manual toggle
• External link crashes: Guard all external link clicks against relative paths and invalid URLs — fixes multiple reported crashes
• Agent duplication flow: Skip the Manual/Guided setup choice modal when duplicating — go directly to the config modal with source agent pre-filled
• Unread filter navigation: Active AI tab is now always reachable via Cmd+Shift+]/[ when unread filter is enabled
• WakaTime settings: Restored WakaTime UI in Encore panel; fixed stale spinner on key change and "installing..." flash
• Cue GitHub poller: Malformed gh CLI output no longer crashes the poll cycle
• Tab navigation glitches: Resolved inconsistent navigation behavior when mixing AI and terminal tabs

What's Changed

• fix: restore WakaTime settings UI in Encore tab by @kianhub in https://github.com/RunMaestro/Maestro/pull/697
• refactor: decompose AutoRun into modular directory structure by @reachraza in https://github.com/RunMaestro/Maestro/pull/698
• Followup: Web Interface UX Parity by @chr1syy in https://github.com/RunMaestro/Maestro/pull/696
• fix: update Codex integration for v0.111.0 JSONL output format by @jSydorowicz21 in https://github.com/RunMaestro/Maestro/pull/699
• feat: polish Cue pipeline editor — drag fix, fan-out/fan-in, viewport centering + fix: Cue pipeline editor polish and input UX improvements by @reachraza in https://github.com/RunMaestro/Maestro/pull/700

Full Changelog: https://github.com/RunMaestro/Maestro/compare/v0.16.5-RC...v0.16.6-RC