The Canvas

The canvas is the heart of Maestri — an infinite 2D space where you arrange your terminals, notes, file trees, and other nodes however feels natural to you. There's no right or wrong layout; the canvas adjusts to your thinking, not the other way around.

Inserting nodes

Select a tool from the top toolbar, then click and drag on the canvas to draw a rectangle. The node appears at the size and position you drew.

Available node types: Terminal, Note, Text, Drawing, and File Tree.

The default size of new terminals and new notes is configurable in Settings → General. Values snap to the 20pt canvas grid, so whatever you set still aligns cleanly with magnetic snapping and groups.

Moving and resizing

• Move — Click and drag from an empty area inside the node (usually the header area at the top).
• Resize — Position the cursor on a corner or edge and drag to the desired size.

Node actions

• Duplicate — Hold while dragging, or right-click → Duplicate
• Delete — W, or right-click → Delete
• Focus in viewport — \ while the node is selected

Tool auto-revert

After picking a tool by shortcut — N for Note, B for Rectangle, or Space for Pan — Maestri automatically returns to the Select tool after a few seconds of inactivity, so you never get stuck in a mode you forgot about. If you start drawing or panning, the timer cancels and you stay in the tool until you're done.

Canvas navigation

Maestri's canvas navigation follows the conventions of design tools like Figma, so it should feel immediately familiar.

Trackpad

• Pan — Two-finger swipe in any direction
• Zoom — Pinch in or out

Mouse

• Pan — Click and hold the scroll wheel, then drag
• Pan + zoom simultaneously — Hold scroll wheel and scroll
• Zoom — Hold and scroll
• Pan (alternative) — Hold Space and click-drag

Keyboard

• Zoom in / out — + / -
• Step along a connection — → / ← walks to the next or previous node connected to your current selection. Works across terminals, notes, portals, and across floors — the order is deterministic so the same key always lands you on the same neighbor.
• Jump to the next agent that needs attention — ⇧A cycles through every terminal showing a red attention dot, across the ground floor and every floor.
• Toggle the minimap — ⇧M opens or closes the minimap popover from anywhere.

Zoom controls and mini map

Zoom controls are available in the bottom-right corner of the app. Next to them is a mini map that shows your current position on the canvas — useful when your workspace has grown large and you've lost track of where things are. The minimap popover can also be toggled from anywhere with ⇧M.

Node groups

When two or more nodes belong together — a Maestro and its recruits, a builder paired with its review note, a portal and the agent driving it — you can bind them into a group. Groups give those nodes a shared, labeled frame so the relationship is visible at a glance, and let you move the whole set in one motion.

• Group — Select two or more nodes and press G. A frame appears around them with a header you can drag.
• Ungroup — Select the group (or any of its members) and press ⇧G.
• Rename — Double-click the group header.
• Move together — Drag the header to move every member at once. Members that are individually locked stay put.

Groups behave like a label, not a wall: marquee selection and clicks still pass through the frame to whatever is inside, so they never get in the way of normal canvas work. Copy/paste, -drag duplication, workspace export/import, cross-workspace clone, and undo/redo all preserve group membership — including connections between members.

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.

• Wall matching — Nodes align to the nearest edge of adjacent nodes.
• Gap filling — Drag a node into an empty space between others and it positions itself to fill the gap cleanly.
• Grid-free — Snapping adapts to your actual layout instead of locking you into fixed sizes.

Release at any time to return to free-form dragging.