File Tree

The File Tree node lets you browse your project's files right on the canvas — no need to switch to Finder or your IDE. It's a fully featured file manager embedded in your workspace.

A file tree node on the Maestri canvas showing a project directory

Inserting a File Tree node

Select the File Tree tool in the top toolbar, then click and drag on the canvas to place it. The file tree opens at your workspace's working directory by default.

You can have multiple file trees on the same canvas, and each one independently remembers its own state — which directory it's showing, which folders are expanded, and which view mode is active.

View modes

Switch between two views using the toolbar at the top of the file tree node:

  • List view — A hierarchical outline, similar to macOS Finder's list view. Supports back/forward navigation and Collapse All.
  • Icon grid — A thumbnail-based view. Images, PDFs, and videos show Quick Look previews instead of generic icons.

Use the toolbar to change the root directory on the fly. Right-clicking a file or folder opens a context menu with options to create, rename, move, and delete.

Dragging files

You can drag files from the file tree directly onto:

  • An agent terminal — Shares the file as context with the agent
  • The canvas — Places it as a native preview node (images, PDFs, and videos are supported)

Tip

You can also drag external files from Finder directly onto an agent terminal or onto the canvas — you don't have to use the file tree for this.