# 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](mailto: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.
