Changelog

Some are making noise with Dots and Bots. In Maestri, you start bands. And run the festival. 🎸

The biggest upgrade to Maestri Floors yet: a whole team, working in parallel, without stepping on each other.

Floors now follow your code onto SSH, Docker and custom runtime workspaces on Linux and Mac, they're real git worktrees, and they speak pull requests from start to finish: open one from a floor, follow it all the way to the merge, or review anyone's on a floor of its own.

• Agent Usage on Your Phone

  Maestri Remote shows the plan rings in a corner of the canvas, with the details in a sheet, and can hide or move them in Settings.

• Design Mode Prompts Take Attachments

  Any file by paperclip, drop, or paste, riding with the prompt to the agent.

• Maestri Chat

  Every terminal now has a chat face, so you talk to your agent in a conversation instead of the raw shell. Replies arrive as formatted text with diagrams, tables and images, you can attach files and drag them back out onto the canvas, mention another agent by name, and watch the shell work behind the conversation while a turn runs. Each terminal keeps seven colored threads, and every conversation survives a relaunch and travels with the terminal.

• Search Chats

  Batuta Search now looks inside every Maestri Chat thread, on every terminal, across all your workspaces and floors. Pick a result and Maestri takes you to it, switching workspace and floor, raising the terminal's chat face on the right thread, and putting the message in the middle of the screen with your term highlighted.

• Rename Workspaces from the CLI

  The `maestri` CLI can rename a workspace.

• Maestri Remote connects faster when you are away from home or coming back to it: the phone now asks every address it knows at once and settles on the private one that answers, instead of waiting out the remembered Wi-Fi address first.
• Performance improvements on long threads in Maestri Chat.

• Maestri Chat

  Every terminal now has a chat face, so you talk to your agent in a conversation instead of the raw shell. Replies arrive as formatted text with diagrams, tables and images, you can attach files and drag them back out onto the canvas, mention another agent by name, and watch the shell work behind the conversation while a turn runs. Each terminal keeps seven colored threads, and every conversation survives a relaunch and travels with the terminal.

• Maestri Chat on Your Phone

  The same thread, live over your connection, in Maestri Remote.

• Agent Usage

  Rings beside the floor indicator show how much of your plan is left on Claude, Codex and Antigravity, with reset times and your plan in the popover. Turn it on in Settings, under Agents.

• Connect Agents Across Workspaces

  Wire an agent to one that lives in another workspace with the same Connect gesture, and address it as "Name @ Workspace". A Maestro can also recruit a teammate straight into another workspace.

• Mermaid Diagrams

  Draw natively in notes and in chat, in the surface's own font and colors, and copy as an image, a diagram, or their source.

• Copyable Tables

  Tables in notes and replies copy as real tables, and double-clicking a cell selects it so you can copy just that one.

• Copy a Portal's Picture

  Right-clicking a portal copies a picture of what it is showing, a web page or a device screen alike.

• Improvements to canvas camera zoom and pan.
• Agent presets now carry an accent color and a terminal theme, on a new Appearance tab, and every way of creating an agent honors them. Maestri Remote can set a terminal's theme and its own font size as well.
• The main window title carries the name of the active workspace, so window managers and time trackers can tell your workspaces apart.
• Maestri Remote shows how many files changed beside a file tree card's branch, spins only the branch row you tapped, and filters files after `#` in the composer the way the Mac does.
• Color swatches can be reached with the keyboard and are announced by name, and the row lines up with everything else in the sheet.
• Shapes round further, all the way from a box to a capsule.

• Design Mode on Portals

  Draw over a web page or a device simulator to select the part you mean, then send it to a connected agent as context to work from. Pick the new brush tool in the portal's toolbar to start.

• Large Pastes in the Prompt Composer

  A big paste folds into a pill instead of filling the composer. Click it to unfold and edit the text in place.

• Media Preview in the File Tree

  Open images, video, audio and PDFs in an editor tab, with playback controls.

• Notes from remote files: drag a text file out of a remote file tree onto the canvas to edit it as a note, saved back over the connection.
• Improved connection reliability for Maestri Remote while your Mac sleeps.
• Open in IDE now knows about VS Code Insiders.

• Maestri Wire

  Now in beta, a new protocol that lets other devices and tools connect to your Mac and control Maestri. Pair a device from Settings → Wire with a QR code or a password, give it read-only or full control, and revoke it at any time. The first thing built on the Wire is Maestri Remote, the iPhone and iPad app, now in review for a public TestFlight. Stay tuned.

• More agents now come back where you left them when Maestri relaunches.

• Persistent Sessions

  Keep an agent running inside tmux so it survives quitting Maestri or losing the connection, and reconnecting attaches to the same agent instead of starting a second one. Turn it on per SSH, Docker, Sandbox, or Custom Runtime connection, or run locally on the new Local (tmux) environment, and end a session at any time from the Processes popover.

• SSH Host Picker

  The SSH sheet now reads the hosts out of your ~/.ssh/config, so picking one fills in the alias and keeps its ProxyJump and identity file applying.

• Descriptive text throughout settings and sheets is easier to read.

• Blur

  Hides the contents of a note or terminal behind a faint icon until you click to restore it.

• Right-to-Left Terminal Rendering

  Arabic and Hebrew text now renders right-to-left in the terminal.

• Fichário Page Locking

  Lock individual pages filed in a fichário.

• Diff Nodes Follow Agent Edits

  While deselected, diff nodes now expand and scroll to each file as the agent edits it.

• Faster terminal drawing for heavily colored and styled output.
• Crisper Powerline separators at any font size.
• A lifted terminal now stays lifted across workspace and floor switches and across relaunches.
• Note search now matches the note's name, not just its first line.
• Terminal apps now pick up a switch between light and dark more reliably.

• Fichários

  Group notes into an elegant tabbed folder: reorder the pages, drag notes in, pull them back out onto the canvas. Agents can file their own connected notes into a Fichário too, unlocking task-based workflows the Maestri way.

• Switch nodes while lifted

  With a node lifted you can now move straight to another one with ⌃⇥, or to a numbered terminal with ⌘1 through ⌘9.

• Preset fonts

  An agent preset can pin its own terminal font, so every terminal it creates starts in that face.

• Bigger Quick Start

  The terminal creation sheet now shows two rows of presets instead of one.

• Mention files with #

  Type # in the prompt composer to open the file picker without going through the @ menu.

• Right-drag to pan

  Turn on Right-drag to pan in Settings → General → Canvas, then hold the right button and drag to move the canvas.

• Reorder Floor hooks commands

  Drag a command by its handle to change the order it runs in.

• 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