Major 0.18.x Additions
π Maestro Web Desktop is the full desktop UI running in your browser. The same interface reaches a tablet or a phone with a layout built for touch, so you can check on a long run, read a transcript, or fire off a prompt from the couch. It can now sit behind a real username and password, with every turn credited to the account that sent it.
πͺ Spread your fleet out. Pull agents into their own OS windows across monitors, split the main window into side-by-side panes to watch two agents at once (or an agent beside its terminal and files), and turn on Pianola, a manager agent that watches the agents you point it at, answers the prompts you have written a rule for, and escalates everything else to you. Pianola is off by default and answers nothing until you write a rule.
π¬ Cross-agent @mentions let your agents talk to each other. Pull another agent into the conversation by name and its answer comes back to you, so your specialists collaborate instead of working alone.
π£οΈ Group Chat leaves Beta. Put several agents in one room with a moderator that decides who works in parallel and who goes in sequence, skips teammates that are already busy rather than starting a second process on your repo, and reports the time the room actually worked instead of how long it sat open.
π― Goal-Driven Auto Run points Auto Run at a single objective in plain English instead of a checklist. Each pass makes one increment of progress and exits, looping until the goal is met. Reach for it on open-ended work you cannot list the steps for, and run it headless with maestro-cli goal-run.
π§© Maestro Plugins turns Encore Features into permission-scoped plugins you manage from Settings -> Plugins. Director's Notes, Cue, Symphony, and Usage & Stats now ride it, and two new ones arrive alongside: Coworking, which lets an agent read your terminal scrollback and look at your in-app browser tabs, with clicking and typing allowed only for agents you add to a list that starts empty, and every interaction audited; and Concerto, which lets an agent draw live panels of stats, tables, and progress on a floating stage instead of pasting a wall of text. Both opt-in.
π€ A major typography evolution. Interface, chat, file preview, editor, Document Graph, and terminal each get their own font and size, with 17 open-license families shipped inside the app and real font detection on macOS and Windows. Cmd+= and Cmd+- zoom everything together, and a first-run chooser offers a proportional Default look or the all-monospace Hacker look.
π€ Five new providers: Antigravity CLI, Grok CLI, Hermes, Oh My Pi, and Pi, local or over SSH.
Other Changes in 0.18.5
Working with your fleet
- π£οΈ One agent can ask another a question with
maestro-cli ask, landing in a private thread instead of interrupting the conversation you have open. - βΉοΈ Stop now halts everything the agent has in flight, including the other agents an
@mentionpulled in. - π Consults have two modes, read-only or read/write, so you decide whether a teammate can change your files.
- π Click the "responding" chip to jump straight to the consult and read the answer in full.
- ποΈ Groups+ organizes a large fleet with two-level nesting, custom icons, and label colors.
- π Give an agent extra working directories, enforced natively by the provider rather than politely requested.
- π Claude Code gains standard permission mode with a live relay, so approvals reach you as they happen.
- π€ The Context Window tooltip names the provider and the account behind an agent, so with several Claude logins in play you can tell whose quota a turn is spending.
- βοΈ A read/write consult now actually gets write access. It used to be told it could apply changes, spawn with no permission at all, and then hang forever on its first edit until a ten-minute timeout killed it and discarded the work.
- π‘ An agent answering a consult shows a busy dot instead of a green "Ready" one, so you can see which of your agents is off working for someone else. It still raises no unread mark and no badge you would have to clear.
- π The Process Monitor lists running consults in their own section, named for who asked whom. They were being counted in the header badge but drawn nowhere, so it read "4 active" over three rows and a consult burning tokens for 26 minutes appeared not to exist.
- π The Context Details popover shows message count and conversation duration, the two figures that previously took an export to read.
- π€ The sidebar alphabetizes agent names from the first real letter or digit, so a leading emoji or symbol no longer files an agent under the wrong letter.
- ποΈ A group chat room can be read as the whole team or as the moderator alone, with a switch in the room header,
Opt+Cmd+G, or the command palette, and a line above the transcript saying how many messages it is holding back. - π Group chat history records your own messages, so every round shows the prompt that started it. A new "You" filter picks them out, and clicking one jumps the transcript to that message.
- ποΈ Group appearance is scriptable.
maestro-cli create-grouptakes--iconand--color, and the newmaestro-cli update-groupchanges a group's name, emoji, icon, color, or parent, and explains why a nesting move is not allowed instead of just reporting a failure. - π¨ When an agent hands work to another agent from its own shell with
maestro-cli dispatchormaestro-cli ask, its transcript shows a pill naming who it went to and what was handed over, instead of a bare command line buried in a tool card. - πΏ Agents create worktrees where you told Maestro to put them, so a branch an agent spins off shows up in the Left Bar instead of sitting forgotten in a hidden folder.
- πΌοΈ A screenshot pasted into one group chat stays in that room. Staged images used to follow you into every other room and go out with the next message sent there.
- π·οΈ Group chat history filters use short labels and a color per type, and drop their icons before they would wrap in a narrow panel.
- β οΈ A Claude agent no longer drops into the blocking error dialog when Claude Code hits a passing API error mid-turn and retries it on its own. The notice waits until the turn actually fails, instead of leaving a live process owning the tab with your next message silently queued behind it.
- π Move an agent to a different folder from Edit Agent, with a folder picker locally and a checked path over SSH, and the Files panel, git, Auto Run and Cue all follow on save.
maestro-cli update-agent --cwddoes the same. - π§ A group chat moderator can no longer claim it handed work to an agent you @mentioned without actually doing it.
- π¬ A group chat's message queue belongs to the room, not the window you typed in.
- β±οΈ Every agent reply says how long its turn took, under the timestamp in the transcript gutter, from
<1mup to5d 6h 25m. A turn broken up by tool and thinking cards reports one figure at the bottom instead of a climbing count on every fragment. - β¨οΈ
@mentionin Group Chat now behaves exactly like it does in AI Chat. Escape closes the popover, Enter on a filter that matches nobody closes it instead of sending your raw@textas a message, and a list that shrank while the popover was open no longer accepts an agent you never highlighted. - π·οΈ A group chat's name is back in its header whenever the row has space for it. It was dropped at every width to fix a phone problem, so a 2000px header read "Group Chat" with the room's actual name nowhere on screen. It is measured now, shown in full or dropped whole, never clipped to "Maes...".
Auto Run, Cue, and automation
- π§ The Thought Stream shows what an agent is doing, not just what it is thinking, with every tool call reduced to one plain line.
- ποΈ A Scheduled Tasks tab in Cue sets up recurring and one-off prompts by clicking instead of editing YAML.
- πͺ Fire a Cue pipeline from anything with a generic webhook trigger.
- π·οΈ Cue can trigger on a GitHub label landing on a pull request or an issue, filtered to the labels you care about.
- π‘οΈ Cue can screen GitHub issues for prompt injection before handing them to an agent, off unless you turn it on.
- πΌ Director's Notes and Cue now start on for new installs, and Settings -> Plugins turns either off.
- π― A new Delegation Score tells you how much of your AI work is running without you in the loop.
- π₯οΈ Agents can finally read a terminal tab's output, so one that started
npm run devcan see what it printed. - πΈ Agents can save a screenshot you pasted them to a real file with
maestro-cli image save. - π A toast an agent fires can open a terminal tab or a browser URL when you click it, not just jump to an agent or a file.
- π΅ "Play this" plays inside Maestro's own floating player instead of launching a separate app.
- π§ Steer a running Auto Run from the Thought Stream panel. A compass button opens a note box, and a strip under the search lists what is still pending and what a task has already taken. Steering used to be triggered by typing into the agent's chat, which quietly turned a message addressed to the agent into an instruction for the run. Typing in the chat is a message again.
- π An Auto Run that stops on an error can pick itself back up, and a run paused on an error or a
MAESTRO:HITLgate hands the document back so you can edit it. - π Auto Run gives up on a document nothing can move instead of dispatching the same unfinishable task forever, refuses to start over a halt marker an earlier run left behind, and no longer mistakes a playbook that merely describes a marker for one that sets it.
- π Auto Run model markers can carry a reason, and the launch dialog can ignore model hints in a document entirely.
- βοΈ The Auto Run editor is the same editor file previews use, with syntax colors and a line-number gutter.
- π±οΈ Auto Run documents run in the order you clicked them instead of being re-sorted.
- π Progress badges keep up during a run, including on SSH agents, and folder rows carry the same badge summed across their files.
- ποΈ Auto Run's document list on an SSH agent loads in well under a second instead of timing out, and a refresh re-reads task counts from disk.
- β±οΈ Auto Run durations record the agent's work rather than your attention.
- π The default Auto Run prompt commits after every task, one task one commit.
- π§ Stopping an Auto Run no longer dumps an error into whatever chat tab you had open.
- π§Ί Cue stops burying your own history: repeated runs collapse into one row per trigger, Cue entries are served from their own store instead of pushing your messages out, nothing trims an agent's history behind your back, and old runs stop appearing twice.
- π The Cue tab gets a chip per trigger type so a noisy heartbeat can be hidden, the pipeline menu can be resized and remembers it, pipeline cards fit what they contain, and Cue gets your real PATH when Maestro was launched from the Dock.
- π§ The Usage Dashboard reports what the Auto Run wizard cost and produced.
- π₯οΈ
maestro-cliresolves your agent's real binary before spawning,dispatch --new-tabdelivers to an agent that is mid-turn, andmaestro-cli snoozeparks, lists, wakes, dismisses and reschedules tabs. - π§΅ Claude agents on the TUI Wrapper or Dynamic token source no longer lose chunks of long prompts.
Reading, files, and git
- πΈοΈ Read the Git Log as a real branch graph, navigate it entirely by keyboard, and switch branches from a dropdown.
- π§ The Document Graph fits on screen, gains radial and concentric layouts, and reads as filename pills when you want the shape rather than the text.
- π Press
#in any markdown preview to jump to a heading, with a Table of Contents that follows your scroll. - ποΈ Fuzzy file search narrows by type with All, Code, Docs, Data, Media, and Other pills.
- π The Memory Viewer opens memories as rendered documents you can edit in place.
- π Opening a pull request no longer holds the form hostage: send it to the background and keep working.
- π¨ Rendered diagrams save straight into your project.
- βοΈ The image annotator gains a crop tool. Press R, drag out what you want to keep, and your arrows, boxes, and labels stay live objects you can still move, with undo restoring the whole frame.
- π Opt+Cmd+R now re-reads the file you are previewing, so a file an agent just rewrote refreshes in place instead of needing the tab closed and reopened. A preview with unsaved edits is left alone.
- π¨
.mjs,.cjs,.mtsand.ctsfiles get syntax highlighting instead of rendering as plain text. - πΈ The Document Graph can screenshot itself. Press C or click Snapshot in the footer to copy the view to the clipboard or save it as a PNG, with the preview pane and legend included.
- π§ Mermaid flowcharts with a filename, a handle, or parentheses in a label now render instead of failing to parse. Measured against 1,222 agent-written diagrams, 427 that used to fail now work, and every diagram that already worked is left untouched.
- π Resuming a conversation from a provider other than Claude no longer shows Maestro's entire system prompt as your first message. The prompt you actually typed is back where it belongs.
- π Send Feedback stops claiming the GitHub CLI is missing when
ghis installed through a version manager shim like asdf or mise, and it honors a custom gh path from Settings. A single failed check at startup no longer marks gh unavailable until you restart. - πΎ Saving a file no longer comes back as a false "File changed on disk" warning about your own edit.
- π
Cmd+Shift+Fputs the caret in the file tree. Enter typed in the markdown editor used to also open whatever file the tree had selected, and the arrow keys moved both at once. - π₯οΈ Terminal tabs start at the size of their pane instead of 80x24, so nano, vim, less, and top fill the tab rather than painting into a small box in the corner. A resize that got lost along the way is retried instead of forgotten.
- β¨οΈ Git Pull, Push, Change Branch, and Create PR can be bound to keyboard chords in Settings -> Shortcuts. They ship unbound, since two of them write to a remote and claiming four default chords for everyone is not a fair trade.
- π Folders the Files panel's depth limit cut off can be opened. A folder at the cap came back with no children, so it drew exactly like an empty folder and its toggle looked broken; opening one now reads it for real, locally and over SSH, and later refreshes keep it.
- π§ Mermaid flowcharts that name a direction Mermaid does not accept, like
flowchart LD,UD, or a lower-caselr, are repaired instead of dying on line one before a single node is read. - π HTML comments stay hidden in rendered markdown. Bookkeeping comments left in a document were printing as visible text in Auto Run, the wizard's document preview, release notes, and phone chat. Auto Run's own marker pills still render as pills.
- π Clicking a file an agent mentions works in more places. A path with a space in it, like
~/Voice Cloning/take.wav, did nothing at all, and a full path outside your project was not even drawn as a link, which is the form agents write most often. - π Search the Git Log.
Cmd/Ctrl+For a bare/filters by hash, message, author, branch, tag, or date, with several words ANDed together, and both the list and the graph answer the same query. - π§΅ A failed git push or fetch reads as plain English. Color codes meant for the command console were reaching the failure toast instead, so a blocked pre-push hook arrived with
[33min front of every word and every progress percentage concatenated into one line.
The browser interface
- π± A real phone layout: drawers, a folding composer, swipe to dismiss, and a tab bar built for thumbs.
- π Switching apps on your phone no longer reloads the page and loses your place.
- π΅ Audio and video play in the browser build, and pasted screenshots finally render there.
- π Agents created or closed in a browser tab now reach the desktop, and a reload stops making busy agents look idle.
- π Sharing your workspace URL produces a proper link preview instead of a bare address.
- π A new setting starts the browser interface automatically when Maestro launches.
- π An Auto Run started in a browser tab now shows up on the desktop app, which used to draw the agent as idle for the whole run.
- π± Added to your iPhone Home Screen, the header no longer sits dead under the status bar with the menu unreachable.
- π± More phone fixes: toasts fit the screen instead of running off the left edge, and the New Agent Wizard's name row no longer overflows both edges.
- βοΈ Renaming a tab from the browser tells you the truth. A rename that fails is reported as a failure instead of a false success, the newest name always wins when two overlap, and one slow rename no longer blocks every later rename of that tab.
- π± The phone composer gets a real options sheet. History, access, thinking, model, and effort move off a wrapping row of pills into a bottom sheet where each one is a list you pick from, rather than a tap-to-cycle control whose options you cannot see.
- π΅ Buttons on the phone stop silently doing nothing. iOS freezes the connection when you switch apps or lock the screen, and the tab comes back on a socket that looks healthy but is gone, so every tap parked forever with no error. Maestro now notices a dead connection and reconnects.
- π¬ Messages sent from a phone are no longer destroyed. One session lost 34 of 35 sends: a stalled connection drew nothing, so each retap raced the last, all of them started at once, and every collision dropped its prompt while leaving a live turn looking idle.
- β¨οΈ On a phone, the tab switcher and file search can be scrolled again. Both opened with their results buried behind the keyboard.
- π‘ The LIVE panel follows your machine onto a new network. Move from WiFi to a hotspot, or wake the laptop somewhere else, and the URL and QR code update in place instead of advertising a dead address until you toggle Live off and on.
- π± The group chat right panel works on a phone. It is a full-screen view there, but a drawer backdrop was still rendering on top of it, so the panel looked dimmed out and every tap meant for Participants or History hit the backdrop instead.
- π The web interface can ask for a username and password. Turn on Web Login in Settings -> Plugins, add accounts there, and a browser has to sign in instead of the URL being the whole credential.
- π Focus belongs to whoever is holding the client. The desktop user switching agents or tabs used to drag every connected browser along with them.
- π± The file preview toolbar on a phone collapses into a "..." sheet. Fourteen icon buttons, a directory path, and a stats bar ate roughly half an iPhone screen before a word of the file was readable.
- π± The running-Auto-Run pill shrinks to its wand on a phone. It was spending a third of the header on "AUTO 124/140" and pushing the controls beside it off the row; the label, the count, and the branch icon fold into its tooltip, and it stays tappable so a run can still be stopped.
- π The Usage Dashboard is readable on a phone. Every tab used to run off the side of the screen, clip its own numbers, or squeeze a quota bar down to nothing.
- π New Tab in a browser draws the tab the moment the desktop mints it, instead of sitting there for up to half a second looking like a dead button. On a phone the keyboard comes up with it rather than making you tap the composer yourself.
- π± Tapping something in a phone drawer now closes the drawer. Picking a group chat, a starred row, or the agent you were already on left the full-screen list sitting over the very thing you tapped, and so did previewing a file you already had open, or opening any audio or video.
- π± The model and effort pills come off a queued card on a phone. At 390px they painted on top of the Force Send button and the icon row beside them; every control in those rows stays.
- π± The Document Graph comes out of the phone Files menu. It is a pan-and-zoom canvas that can only hold a couple of nodes on a phone, which cannot show the shape of a document set, and it was spending three rows of a menu that already ran past the bottom of the screen. The command palette and its chord still reach it there.
Comfort and polish
- β Press
!in the composer to run a shell command right in the chat, and press it again to describe the command in plain English and let the model write it. - π¦ A new first-run step lets you opt into release candidates, crash reports, and update checks, and installs the Maestro CLI in one click.
- β° Snooze a tab until later and hand the agent a prompt to run the moment it wakes.
- ποΈ A two-axis console for picking model and reasoning effort, with type-to-jump.
- πΉ Pianola switched off in Settings -> Plugins now stays off.
- π On macOS, agents can finally be granted calendars, reminders, contacts, photos, the local network, and your Desktop, Documents and Downloads folders.
- π SSH gets per-remote options for an exotic transport or a bastion host, an agent that can be told how to run another agent on your other machine, and a working directory typed as
~/somethingthat actually starts. - ποΈ Switch an environment variable or SSH option off with an eye button instead of deleting it.
- πΎ Maestro will not overwrite your agents or your groups with an empty file it never successfully read.
- π§± Your queued work survives a bad turn. A prompt that hits a quota wall goes back to the front of its queue, Stop no longer eats the next queued message, and closing a tab mid-outage stops destroying the message the retry was holding.
- β³ A quota outage checks back instead of sleeping until the advertised reset.
- π Maestro stops auto-retrying a request that repeating cannot fix, and a Codex agent out of plan credits waits instead of hammering the provider for hours.
- ποΈ Redeem a Codex usage reset credit without leaving Maestro.
- π Usage and quota numbers follow the credential an agent actually runs on, a plan you have capped stays on the dashboard, Auto Run turns are counted once, Peak Usage records stop going down, and stats survive an install that has run an RC build.
- π The Tokens tab splits spend by provider account for every provider, not just Claude, and its timeline legend toggles series on and off.
- π Usage Dashboard tiles stop truncating names to "Ma...", gain a zoom on bare
+,-and0, and carry Jump to Agent and Agent Settings. - πΌοΈ Transcripts full of pasted screenshots scroll smoothly again.
- π Chats and file previews reopen exactly where you left them, even after images and code highlighting settle.
- β¨οΈ Maestro stays typeable during a long turn, and burns less CPU while your agents work.
- π€ A cold start no longer flashes the splash screen and wordmark in Courier New before the real font loads.
- β¨οΈ Keyboard chords show up beside the controls that fire them, shortcuts are findable by what they do rather than their exact name, and any binding can be unset with the Γ beside it.
- β¨οΈ
Cmd+Eflips a markdown preview into the editor even when nothing has claimed focus, and closing a tab under the unread filter lands you on a tab the filter still shows. - βοΈ Dragging a tab toward either end of a crowded tab bar scrolls it.
- π¨ Themes get a new Indigo Blue, a Pedurple that finally contains Pedurple, a retired InQuest, and a CLI theme change that shows up right away instead of at the next launch.
- π΅ The floating media player stops vanishing on you, its queue and history lists answer Escape themselves, and you can copy the loaded file's name out of the title bar.
- π Queued messages render as markdown like the rest of your chat.
- π Built-in browser tabs paint in your theme instead of flashing white, the address bar stops flickering at the bottom of a page, and
Cmd+Vpastes into fields again. - π§ A wizard tab names itself from what it is planning, and the New Agent Wizard's provider tiles fit a short window instead of overflowing it.
- π§ Tool rows in the Thought Stream put the time and status glyph above the call instead of beside it.
- πͺ First run asks for less and says more. The agent name is optional and defaults to your folder name, an agent pointed at a folder that already has files in it opens by reading the project and telling you what it found instead of asking you to describe it, every planning turn names the model it is running on, and the directory step offers "just create the agent" for a project that brings its own planning.
- π€ Environment variable names suggest themselves as you type, from a short per-provider list of the ones people actually reach for plus every name you have already set anywhere in Maestro. Typing
CLAUDE_HOMEwhen you meantCLAUDE_CONFIG_DIRused to set a variable the CLI ignores with nothing to tell you. Only names are remembered, never values, so a saved API key is never copied anywhere. - π A queued message offers "Show all" only when something is genuinely hidden behind it. A two-line message used to get a toggle whose expanded and collapsed states looked identical, labelled with a count of newlines; cards now preview 600 characters and name the characters actually held back.
- π© The Usage Dashboard donut charts have room for their center label. A long total like "831h 23m" used to run underneath the ring.
- π§Ή Also fixed: installing the Maestro CLI on Windows adds it to your PATH again, "Move to Group" and "Move to Window" work in the Left Bar right-click menu, Director's Notes shows an error and a Regenerate button instead of spinning forever, Escape on Snooze History goes back one level, the Share menu reports whether the copy worked, the Document Graph font setting changes the graph's text, a turn under a cent reads
<$0.01, and the execution queue ages an item in days rather than minutes.
Full Changelog: v0.18.4-RC...v0.18.5-RC