Notes

Notes look like simple sticky notes on the canvas, but under the hood they're real markdown files saved to disk. Maestri includes a fully featured markdown engine with live preview — and agents can read and write them through the Maestri CLI.

Creating a note

Select the Note tool from the top toolbar and draw a rectangle on the canvas. A new .md file is created in Maestri's storage folder and pinned to the canvas.

Raw and formatted views

Every note has two viewing modes, toggled from the contextual toolbar at the top of the note:

• Raw — A plain text editor. Write markdown directly.
• Formatted — A rendered preview. Tables, headings, code blocks, bold, italic — all rendered in real time.

Custom note names

By default, a note's name is derived from its first line of text. To set a stable name that won't change when you edit the content, double-click the note's header or right-click → Rename.

Note chaining

Notes can be connected to other notes to create a hierarchy. Connect a note to another note using the same Connection tool you'd use for terminals — a cable links them.

When an agent is connected to the entry-point note, it can access the entire chain. This is useful for organizing large amounts of context into a mind-map structure that the agent can navigate.

Custom file location

By default, notes are stored in Maestri's internal storage folder. To save a note somewhere specific in your project:

1. Open the note's contextual toolbar.
2. Select Move to... and choose a path.

The file lives at your chosen location from that point on. Note: if you later delete the note from the canvas, the file is not removed from your custom location.