Changelog

Maestri is frequently updated with new features, improvements, and fixes based on user feedback. Got an idea or something not working as expected? Reach out at bugs@themaestri.app.

Features

• 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.

• 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.

Bug Fixes

• Fixed an issue that prevented microphone dictation from working in terminals.

Point Releases

• 0.23.1 — April 28, 2026
  Resolved a crash caused by layout-phase reentrancy in certain window configurations.

• 0.23.3 — April 30, 2026

  • Improved Markdown Tables— Tables now render with proper column sizing, text wrapping, and cleaner visuals.
  • Clickable Links— Links in your notes are now clickable. Cmd+click to open in your browser.
  • Hermes Support— Maestri skills are now automatically provisioned for Hermes agents alongside Claude Code.
  • Stability & Performance— Fixed a memory leak in terminals and improved diff loading reliability.

• 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.

• 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.

Bug Fixes

• Fixed a freeze when scrolling through large diffs.
• Local file paths in portals no longer mishandled as remote URLs.

Point Releases

• 0.22.1 — April 25, 2026

  • Bracketed paste in terminal— Pasted file paths and screenshots now register as attachments.
  • Drag & drop files into terminal— Drop any file or image onto the terminal and it's wrapped as an attachment for the running CLI.
  • Smarter SSH setup— Maestri shows actionable hints when a server asks for a password.
  • Editable directory picker— Click the path field to type or paste a directory directly.
  • SSH workspaces out of beta— The Experimental badge is gone now that the SSH workspace flow has graduated.

• 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
  Select a diff and hand it to any agent in your workspace for a second opinion.

• Autonomous Portal Agents
  Agents can now run more actions inside portals: hover, drag, click through iframes, and scroll with intent.

• Portal UX Refinements
  Press ⌘⇧Click on any link in a terminal to open it as a new portal on the canvas.

• 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.

Bug Fixes

• Reduced memory usage for image nodes and terminal restoration.

Point Releases

• 0.21.1 — April 16, 2026
  Small design fix in the diff viewer.

• 0.21.2 — April 16, 2026
  Fixed custom workspace icon clipping.

• 0.21.3 — April 16, 2026

  • Smoother diff viewer— Fixed a periodic canvas and terminal stutter.
  • Correct git scope— The diff viewer now operates on the file tree node's own directory for git actions.

• 0.21.4 — April 16, 2026

  • File tree in sync— Fixed stale file tree diffs after repeated edits.

• 0.21.5 — April 16, 2026

  • Branches sheet refresh— The Branches sheet now lists branches inline with search and checkout confirmation.
  • Smarter canvas paste— Copying nodes preserves their internal connections and file-tree paths.

• 0.21.6 — April 19, 2026

  • Cleaner portal teardown— Fixed portal web view teardown and storage cleanup.

• 0.21.7 — April 19, 2026

  • Add menu on the canvas— Right-click an empty spot on the canvas to open a new Add submenu.

• 0.21.8 — April 19, 2026

  • Focus reliability— More fixes to prevent the occasional unresponsive-window state.

• 0.21.9 — April 19, 2026

  • Stability fix— Resolved a main-thread freeze that could occur when renaming nodes.

• 0.21.10 — April 21, 2026

  • Smoother canvas performance— Panning and navigating large workspaces is now significantly faster.

• 0.21.11 — April 22, 2026

  • Portal stagger deadlock fix— Resolved a deadlock that could freeze the workspace when loading multiple portals.

Work on multiple ideas in parallel, embed live browser views, and connect to remote machines over SSH.

Floors

Work on multiple ideas in parallel without losing context.

Browser Portals

Embed live browser views on your canvas.

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.

SSH Workspaces

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

Design polish and stability improvements throughout.

Point Releases

• 0.20.1 — April 9, 2026
  Fixed a crash when deleting empty portals.

• 0.20.2 — April 9, 2026
  Instant notes— Click anywhere on the canvas to create a sticky note.

• 0.20.3 — April 9, 2026
  History browsing— Improved navigation through past commits.

• 0.20.4 — April 10, 2026
  Focus reliability— Improved focus management.

• 0.20.5 — April 10, 2026
  Clone Ground layout— Optionally duplicate all elements from Ground when creating a floor.

More Features

• Note Chaining
  Connect notes to each other so agents can access entire chains through a single terminal connection.

• 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.

• More Reliable Agent Communication
  The inter-agent server now monitors its own health and automatically recovers if something goes wrong.

Bug Fixes

• Scrollbars and text selection in notes now match the note's appearance regardless of system theme.