Changelog

• 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