Changelog

• Mention files from a remote machine

  Type @ in the prompt composer of an SSH, Docker, or custom runtime terminal to browse and mention files from that machine, not just your Mac.

• Mute a portal

  Right-click a browser portal and choose Mute to silence it.

• Dock a panel to the edge

  Double-click a node to lift it to the center, then drag it to a screen edge to park it as a full-height column that stays put while the canvas pans and zooms underneath. Double-click again to send it back to its place on the canvas.

• Partitura contents

  Leave elements out of a partitura before sharing or accepting it, or send the board with its notes blank, without carrying your file paths along.

• Colored mentions

  A terminal mention now wears that terminal's color instead of the accent.

• Unload a floor

  Right-click a floor in the overview to release its terminals and portals while the rest of the workspace keeps running.

• Software keyboard

  Show or hide the iOS keyboard from the device portal toolbar.

• Command help

  `maestri <command> --help` now explains the command and its flags.

• Cable ties

  Option-drag a stroke across connection ropes to bundle them under a zip tie, which you can drag to re-seat the bundle or delete to let the ropes fall loose again.

• New Element Defaults

  Right-click a terminal, note, or portal and adopt its current size, font, theme, or color as the default for everything you create next.

• Grab a note anywhere up top

  The top band of a note now moves it, sized on screen so it stays easy to grab however far you zoom out.

• Portal size readout

  Choose whether a portal shows its width and height never, only while resizing, or always, so you can see the exact width a layout breaks at.

• Lift and hover focus for file trees

  File trees now expand into a centered panel and can be activated on hover, with a wide split layout when the editor pane is open.

• Lift

  Double-click a note, terminal, or portal header to expand it into a centered panel for focused work, or bind a shortcut for it in Settings → Shortcuts.

• Floor clones in the background

  Creating a floor with repository isolation now copies behind a progress pill, so you can keep working instead of waiting for it.

• Focus on hover

  Optionally activate a terminal, note, or portal just by moving the pointer onto it, from Settings → Canvas.

• Partituras

  Save a whole corner of your canvas — agents with their roles, notes, portals, drawings, and every rope between them — then drop it onto any floor or workspace, or send the file to a friend so they get your exact setup in one click.

• Remote file trees

  Put a file tree node on an SSH host, Docker container, or Sandbox and work in it exactly as you would locally: list and icon modes, sorting, pinning, file management, the inline editor, content search, and git. One sheet picks both the folder and the environment, whether you're creating the tree or moving an existing one.

• Rendered markdown in the file editor

  Markdown files open in the same live editor the sticky notes use, with headings, tables, checkboxes, and code blocks. Flip any tab between source and rendered, or set the default in Settings → File Editor.

• Prevent Sleep

  Keep your Mac awake while agents are working so a long run doesn't stall when you walk away.

• Sessions survive unloads

  Unloading a terminal or workspace hands off agent sessions the same way quitting does, so reloading picks up where you left off.

• Stable note names

  Agents can pin a note's name with `maestri note create --name`, so it stays addressable no matter how the content changes.

• File mentions

  Type `@` in Prompt Composer, choose `File…`, then search your project and attach a file to the prompt.

• Import Workspace

  Open a shared `.maestri` archive from the File menu, review what's inside, then choose where it lands.

• Android portals

  Typing, rotation, and press-and-hold gestures now work on Android devices.

• Smart Draw

  Sketch freehand and the stroke snaps into a clean line, arrow, rectangle, diamond, triangle, ellipse, star, or heart the moment you lift the mouse.

• Shape library

  A new grid of area shapes: hexagon, stadium, parallelogram, star, heart, x-box, check-box, block arrows, and a cloud that reflows its bumps as it resizes.

• Adjustable corners

  Scrub any shape's corner radius from sharp to fully rounded.

• True solid fills

  Solid Fill is now genuinely opaque instead of a light wash, and text inside stays readable.

• Brush

  A pressure-style brush beside the pen, with strokes that thicken and taper as you draw.

• Find in terminal

  Press ⌘F to search a focused terminal's output, with a match counter and next/previous.

• Element search

  Jump to any element in the workspace with ⌥⌘E, across every workspace with ⇧⌥⌘E, or from the canvas right-click menu.

• File editor defaults

  Pick the font, size, tab width, and line wrapping new file editors open with, in Settings → New Item Defaults.

• Composer stays put

  The Prompt Composer no longer vanishes when you click elsewhere on the canvas, so you can drag a file out of a file tree straight into your draft.

• Resize cursors on shapes

  Selection handles now show the matching resize arrow, rotated to follow a tilted shape.

• Delete shapes with ⌘W

  The delete-element shortcut now clears selected drawings alongside terminals instead of leaving them behind.

• Smoother streaming

  Terminals do far less layout work while an agent streams output.

• Docked Prompt Composer

  ⇧⌘P or the terminal toolbar cycles to a new Below placement that stays life-size under the terminal at any canvas zoom.

• Terminal padding

  Set horizontal and vertical breathing room around terminal content in Settings → Terminal → Appearance.

• Stability

  Fixed an issue that might cause the app to hang when interacting with terminal scrollbars.

• Maestri Device Portals

  A device runtime built from scratch, so your agents drive real iOS and Android devices at native speed. Drop an iOS Simulator, Android emulator, or a plugged-in Android phone next to your agents on the canvas, connect it, and it just works. The portal draws the device's own display buffer straight to the GPU and sends input through the device's native input pipeline, so it stays smooth and instant instead of crawling through screenshots and shell commands, while agents read the running app's real element tree — true labels and exact positions — so a tap lands on the button rather than a guessed coordinate. Build your project, install it, launch it, tap, type, swipe, rotate, and screenshot, all in one place with no XCUITest, no Appium, and no extra tooling. Search and filter across every simulator, emulator, and phone you have, spin up a new simulator from a searchable model list, and start it all with a New Device Portal action right in the prompt composer.

• Smart Session Restore

  Quitting used to mean losing every conversation in flight. A novel approach means it doesn't anymore: Maestri saves each agent's session on the way out and picks the conversation back up when you relaunch, whether you quit yourself or the app just updated. It works with the CLI you already use — Claude Code, Codex, opencode, and any other agent CLI that can resume — with nothing to configure. You can also require a confirmation on ⌘Q, so a stray keystroke doesn't stop your running agents.

• Meet Prompt Composer

  Maestri blends TUIs and GUIs like never before with a new rich composer that floats over any terminal with Cmd+Shift+P. It's fully integrated with the canvas so you can mention connected agents, notes and more with unmatched UX.

• Maestri Environments

  In addition to SSH you can now connect workspaces to Docker Containers and Sandboxes with first-class support.

• Maestro notifications

  Maestro-enabled agents can now run `maestri notify` to send you a system notification when they truly need your attention. No more babysitting, just tell them to notify you when they finish.

• Maestro mode

  Maestro-enabled agents can now see and manage all the connections on their recruits, and a new `--replace` flag lets them replace a recruit without dismissing it first.

• Workspace-scoped roles

  Organize agent roles by workspace, with global roles still available everywhere.

• Connect All to…

  Select several nodes and wire them all to a single target in one pass from the command palette.

• Sticky note locking

  Lock a sticky note to make it read-only.

• Group colors

  Assign a color to a group to tint its frame and header.

• macOS 15 Sequoia support

  Maestri now runs on macOS 15.4 and later. Some features might not be available and support will not be guaranteed in future releases.

• Mini Sidebar

  A compact workspace rail that keeps your workspaces within reach, toggle it from View → Toggle Mini Sidebar.

• Align & Distribute

  Align selected nodes and drawings left, right, top, bottom, or center on either axis, and distribute them evenly with equal gaps.

• Zoom to Selection

  Frame exactly what you've selected with the camera, from the View menu, Batuta, or a remappable shortcut.

• New Item Defaults

  Pick a default note font and render mode for new notes.

• New Workspaces & Floors from the CLI

  Maestros can now provision new workspaces and floors directly from the maestri CLI, gated behind Maestro permissions.

• Recruit to Any Floor

  Maestro can now spawn agents directly onto a specific floor with `--floor`.

• Copy Path

  Right-click a workspace in the sidebar to copy its folder path to the clipboard.

• New Folder in Pickers

  Directory pickers now show a New Folder button so you can create folders mid-browse.

• File Editor

  Open and edit any text file right on the canvas in a fully native text editor, custom-built for Maestri from the ground up: syntax highlighting, find & replace, multi-cursor editing, auto-closing brackets, smart indentation detection, line operations, and go-to-line. Tune the font, tab size, and keyboard shortcuts in Settings, and select any text to send it straight to an agent.

• MaestriMarkdown 2

  A new version of the native Markdown engine used on notes, featuring dramatically improved performance and resource usage, so even much larger notes render with ease.

• Search Files in Batuta

  Select a file tree node and press ⌘P to fuzzy-search every file inside it, with relevance-ranked results you can open straight in the editor.

• Find What Needs You in Batuta

  A new Notifications action lists every terminal awaiting attention across all workspaces and floors, with a live count. Press Return to jump straight to it.

• Connection Routing

  Choose whether connection lines route around nodes or pass behind them, keeping crowded canvases visually cleaner.

• Smarter Node Placement

  Agent-spawned notes and portals now find the nearest open spot instead of stacking on top of existing nodes.

• Batuta Search

  A new command palette (Cmd+P) to instantly jump to terminals, notes, and portals, run actions, and search across your workspaces from the keyboard.

• Open Files from the Terminal

  Cmd+click a file path in any terminal to open it.

• Unload Terminals and Portals

  Free up resources by unloading individual terminals or portals when you don't need them.

• Sharper Terminal Rendering

  The Metal renderer now scales dynamically with zoom, keeping text crisp at any size.

• Czech Keyboard Fixes

  Improved support for Czech keyboard layouts.

• Make Your Notes Yours

  Custom fonts land on sticky notes. Give your canvas the personality it deserves.

• Richer Markdown

  Crisper syntax highlighting plus polished rendering for images and checkboxes.

• Light, Dark, Your Call

  Force Maestri into light or dark mode, or let it ride with your system.

• Smarter Routines

  Kick off a setup script before a run, and skip the run entirely when an agent's already heads-down.

• Stay Logged In Across Portals

  Set a default storage scope so new browser portals share your sessions instead of making you sign in again every time.

• More Agent Superpowers

  Agents can now delete connected notes and close connected portals.

• Maestro Mode, On Tap

  Pin a terminal preset to always launch in Maestro mode. Your orchestra shows up ready to play.

• Smoother All Around

  A pile of bug fixes and performance wins.

• Antigravity CLI

  First-class support for Google's Antigravity CLI. Heads up: agent roles aren't supported yet due to a bug in the Antigravity CLI 1.0.

• Skills Settings

  A new Skills preferences pane lets you manage where Maestri installs its skills and customize their base locations across agents.

• Focus Freeze Fixes

  More fixes for the rare "focus freeze" issue.

• Node Groups

  Group related nodes under a shared header that drags, renames, and stays organized together.

• Custom Terminal Themes

  Pick from built-in iTerm2 schemes or import your own color folders to style every terminal exactly how you like.

• Commit History Graph

  File tree nodes now show an inline commit-history graph so you can scan a repo's recent activity without leaving the canvas.

• Attention Notifications

  Get a native macOS notification when an agent needs your attention, even when Maestri isn't focused.

• Discover Roles

  Browse and share roles with new role.json metadata, plus CLI commands to inspect, write, and edit them.

• SSH Image Uploads

  Drag images onto an SSH terminal to stream them straight to the remote host.

• Configurable Default Sizes

  Set your preferred default size for new sticky notes and terminals so the canvas opens the way you want.

• Camera in Portals

  Web pages opened in a portal can now access the camera, matching the existing microphone support.

• Step Into Edit Mode

  Walking a chain of connected notes, portals, or text blocks with Cmd+Option+Arrow now lands you ready to type, even mid-edit.

• Maestro Mode

  Turn any terminal into a manager that can recruit, role, connect, and dismiss other agents on your canvas, so a lead agent can spin up its own team and orchestrate the work.

• Routine History

  Every routine fire is now recorded in a new History tab, so you can review what ran, when, and what happened — even after one-shot routines auto-remove themselves.

• Reset Focus

  A new View menu action clears any active focus and brings you back to the full canvas.

• Sharper Metal Renderer on Non-Retina Displays

  Super-sampled rendering keeps terminal text crisp on standard-resolution monitors.

• Smarter Terminal Start-up

  Start-queue spacing adapts to how many terminals are launching, so larger workspaces come up faster without stampeding.

• Metal Renderer

  Enable GPU-accelerated terminal rendering from Settings to reduce CPU usage and improve overall smoothness.

• Native Scroll Bars

  Terminal scroll bars now follow your system preference (overlay or legacy) and auto-hide when idle.

• Git File Actions

  Right-click any changed file in the diff view to stage, unstage, or discard it individually.

• Improved File Search

  Search results in the file tree now display filenames and paths on separate lines for easier scanning.

• Smoother Zoom

  Canvas zoom with non-precise scroll devices is now more gradual and controlled.

• Lifecycle Hooks

  Attach setup and teardown scripts to your floors. When you create a new floor, hooks run your setup commands automatically — and clean up when it's time to land. Perfect for bootstrapping environments and keeping quick actions at your fingertips.

• Remote Branches

  Remote branches now correctly show up in the branches sheet, so you can browse and checkout any branch across your remotes.

• Smarter Snapping

  Nodes now snap to nearby edges more naturally with refined magnetic alignment.

• Agent Notes

  Coding agents can now create and link sticky notes to their terminal from the CLI.

• Routines

  Automate your workspace by scheduling prompts that run on your agents at set intervals. Separate prompts with && on its own line to build multi-step workflows — each one is sent as a new message in sequence.

• Magnetic Tile Snapping

  Hold ⌘ while dragging a node and it snaps into mosaic-style layouts, automatically matching walls and filling gaps for a clean, tiled workspace.

• Canvas Backgrounds

  Choose between grid, plain, or transparent backgrounds for your canvas.

• Diff Viewer

  Browse code diffs directly in Maestri, with sticky file headers, collapsible files, conflict detection before merging branches, and smooth layout throughout.

• Agentic Code Review

  Something feels off about a diff? Select it and hand it to any agent in your workspace for a second opinion. Don't let slop ship.

• Autonomous Portal Agents

  Agents can now run more actions inside portals: hover, drag, click through iframes, and scroll with intent. They can also spawn a brand new portal on the canvas when they need to open a URL.

• Portal UX Refinements

  Press ⌘⇧Click on any link in a terminal to open it as a new portal on the canvas. You can also set each portal's storage scope — per instance, per workspace, or global — so portals can share an existing logged-in session when you need them to.

• Custom Workspace Icons

  Give each workspace its own look with a custom image icon.

• Canvas Zoom

  Zoom now centers on the right point with a smooth animation.

• Reduced memory usage for image nodes and terminal restoration.

Work on multiple ideas in parallel, embed live browser views, see Git status in the file tree, and connect to remote machines over SSH.

• Floors

  Work on multiple ideas in parallel without losing context. Each floor is an isolated workspace with its own canvas, optionally backed by a git branch using instant copy-on-write clones. Toggle the 3D overview to see all your floors at once, then land changes back to your main workspace when ready.

• Browser Portals

  Embed live browser views on your canvas. Agents can navigate pages, click elements, fill forms, and read the accessibility tree — perfect for testing web UIs or automating workflows. Each portal has persistent isolated storage.

• Git in the File Tree

  See file status at a glance with inline badges. Stage, unstage, discard changes, and commit directly from the context menu. A new commit history tab lets you browse past commits and undo mistakes.

• SSH Workspaces

  Connect to remote machines and work on distant projects as if they were local (experimental).

• Design polish and stability improvements throughout.

A completely redesigned inter-agent experience. The maestri CLI has been rebuilt from the ground up so your agents can collaborate faster and more reliably — with zero external dependencies.

• Terminal Selection

  Text selection no longer clears while output is streaming, so you can freely select and copy at any time.

• Performance

  Fixed a compositing issue that caused GPU overhead when multiple terminals were on the canvas.

• Built-in Diagnostics

  Run `maestri debug` to instantly troubleshoot connection issues.

• Introducing the All-New File Tree Node

  Browse your entire project without leaving the canvas with a fully featured file manager — search, outline and icon grid views, context menus for creating, renaming, moving, and deleting files, and a toolbar to switch root directories on the fly. Drag files directly onto agents or anywhere on the canvas to share context instantly.

• Auto-Scroll Lock

  Lock any terminal’s auto-scroll to stop it from jumping to the bottom, so you can read through the output at your own pace. Fully customizable shortcut in Settings.

• Forward Navigation & Collapse All

  The File Tree now supports back/forward navigation just like Finder, plus a Collapse All option in list view.

• Thumbnail Previews

  Images, PDFs, and videos show Quick Look thumbnails in the File Tree instead of generic icons.

• Custom Note Names

  Double-click a note’s header or right-click and choose Rename to set a stable name that won’t change when the content is edited.

• Configurable Zoom Modifier

  Choose your preferred modifier key for canvas zoom, with automatic conflict detection against workspace swipe.

• Smoother Terminal Scrolling

  Refined scroll behavior in terminals, especially for coding agents using alt-screen like OpenCode and Claude Code’s new CLAUDE_CODE_NO_FLICKER=1 mode.

• Higher-Fidelity Workspace Export

  Terminals now render with full detail when exporting canvas snapshots.

• Sticky Note Reliability

  External note files are no longer overwritten by auto-save, and content is properly flushed to disk before moves.

• TUI Mouse Fix

  Fixed mouse hover incorrectly triggering clicks in TUI apps with interactive elements.

• Faster Markdown Rendering

  Significantly improved the performance of the Maestri markdown engine for sticky notes.

• Chained Notes Hierarchy

  Fixed the ordering of chained notes so nested note trees display correctly.

• Updated to SwiftTerm 1.13.0

  Includes latest upstream fixes for keyboard handling and font reflow.

• Video Preview

  Drop video files onto the canvas and preview them with a native player, right alongside your notes and terminals.

• Reliable Toolbar Tooltips

  Toolbar tooltips now work consistently when switching between nodes, and show keyboard shortcuts where available.

• Better File Copy

  Cmd+C on file nodes now copies the actual image or file to the system clipboard, so you can paste into other apps.

• Rename Polish

  Clear a custom note name in the rename popover to revert to automatic naming, and terminals no longer steal focus while renaming.

• Design polish and performance improvements.
• Stability fixes and design polish.

• Note Chaining

  Connect notes to each other so agents can access entire chains through a single terminal connection. Build mind maps with notes and agents will understand their hierarchy.

• Connect Shortcut (Cmd+L)

  Quickly start a connection from any selected terminal or note — no need to reach for the toolbar.

• External File Notes

  Drop .md, .markdown, or .txt files onto the canvas to work with them as sticky notes while keeping them at their original location.

• Lower GPU Usage

  Optimized terminal rendering for better performance, keeping your Mac cooler and fans quieter.

• More Reliable Agent Communication

  The inter-agent server now monitors its own health and automatically recovers if something goes wrong.

• Smoother connections — rope physics improved with softer corner rounding for a more natural look.
• Performance optimizations for smoother canvas navigation on large workspaces.

• Introducing Agent Roles

  Create reusable roles with custom instructions, assign them to terminals, and let each agent focus on what it does best. Build multi-agent workflows where each agent has a clear responsibility — one leads, one codes, one reviews, one tests.

• Role Management

  Create, edit, and organize roles in the new Agents tab in Settings.

• Visual Role Badges

  Each terminal displays its assigned role with a colored badge.

• Automatic Agent Instructions

  Maestri places role instructions where agents can read them at startup.

• Role-Aware Agent List

  maestri list now shows each agent's assigned role.

• Smart Cleanup

  Role files are created and removed automatically as you assign and unassign roles.

• Workspace Directory Propagation

  Changing a workspace's working directory now automatically updates all terminals that use the old default. No more editing each terminal individually.

• Toolbar Tooltips

  All contextual toolbar buttons now show tooltips on hover, making it easier to discover what each icon does.

• Icon picker expanded to 40 icons with scrollable grid and emoji support.
• New custom color orb opens the native macOS color panel.
• Directory picker now opens at the current directory instead of root.
• Badge text color adjusts to light or dark tints for readability.

• Per-Workspace IDE Preference

  The IDE button now remembers your choice per workspace, so each project opens in the right editor automatically.

• GPU-Accelerated Terminal

  Enjoy even smoother terminal sessions thanks to an all-new GPU-accelerated backend, powered by the latest release of SwiftTerm.

• Per-Terminal Working Directory

  Set a custom starting directory for each terminal instead of always inheriting the workspace default.

• Native Font Picker

  Choose your terminal font with a native macOS font picker right in settings.

• International Keyboard Support

  Terminal now correctly handles Option+key combinations for typing characters like @, #, and { on non-US keyboard layouts. A new toggle in Settings > Terminal lets you switch Option back to Meta if needed.

• CJK Input Support

  Formatted sticky notes now handle Chinese, Japanese, and Korean input methods correctly. Text no longer disappears or jumps during IME composition.

• Smart Copy

  Improved text reflow when copying indented paragraphs from the terminal.

• Stability improvements for inter-agent communication.

• CMD+Click URLs in Terminal

  See a link in your terminal? Just CMD+click it to open in your browser.

• Smart Copy (⌘⇧C)

  Copies terminal text as clean, readable paragraphs instead of broken lines.

• Smarter Connection Lines

  Ropes now route around terminals in the way instead of cutting through them.

• Canvas Right-Click Paste

  Right-click anywhere on the canvas to paste exactly where you clicked.

• Improved performance on markdown rendering for notes
• Allow images to be dropped on terminals
• Cmd+W now properly closes sticky notes and text nodes
• Text nodes support multiline editing with Shift+Enter
• Terminal rename field auto-focuses when triggered from the context menu
• Design fixes and stability improvements