Changelog

• 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