Connections

Connections are one of Maestri's core features. They link terminals and notes together with physics-animated cables, and they unlock real communication between agents — across any CLI tool.

Inter-agent communication

When two terminals are connected, Maestri installs a Maestri Agent Skill in each one. This skill gives agents the ability to send prompts to, and receive responses from, any other connected agent.

Any agent that starts inside Maestri will automatically know how this works. You can prompt one agent to ask another:

"Ask the Reviewer to look at the current implementation."

Since the skill works at the CLI level, it's agent-agnostic — Claude Code can talk to Codex, OpenCode can talk to Claude, any combination works.

Keep the receiving agent unselected

When one agent sends a prompt to another, leave the receiving agent unselected (no dashed border around it). Maestri only monitors terminals that aren't currently focused. When the receiving agent finishes generating its response, Maestri detects this and sends the answer back to the original agent.

If you select the receiving agent, Maestri assumes you want to take manual control and stops monitoring it — which means the waiting agent will never get its response.

Creating a connection

Method 1 — Toolbar: Select a terminal, then click the Connection tool in the toolbar. A line follows your cursor. Click the second terminal (or note) to complete the connection.

Method 2 — Keyboard shortcut: With a terminal selected, press CtrlL to start a connection from the keyboard.

A rope-like cable with physics animation links the two nodes. You can have multiple connections on any terminal.

Connection styles

Maestri ships with two connection styles, and you can switch per connection:

• Rope — The default. Cables hang and sway with physics, so connections feel alive as you drag and rearrange nodes.
• Circuit — Connectors draw as axis-aligned traces with at most two rounded 90° turns, skipping the rope physics entirely. Cleaner for dense canvases where you want connections to read like a circuit board instead of a tangle of ropes.

Switch the style from the connections popover on any connected node.

Cable ties

Once several ropes run through the same stretch of canvas, you can bundle them. Hold Alt and drag a short stroke across the ropes you want gathered. Every rope the stroke crossed is pulled through a cable tie where you drew it, converging at the tie and fanning back out on each side, the way you would tidy the cables behind a desk.

The bundle stays live. The ropes keep their physics, and the tie follows the nodes they connect.

• Re-seat the bundle — drag the tie's band to move it along the ropes.
• Let the ropes loose — click the tie to select it, then press Delete.

A cable tie is purely visual. It changes how connections are drawn, never what they do, so the agents on either end keep talking exactly as before. Removing one leaves every connection intact.

Agent-note connections

You can connect a terminal to a note instead of another terminal. When connected, the agent can read and edit the note's content through the Maestri CLI.

Think of it as giving the agent a persistent notebook — a shared place where you can both write things down that survive across sessions, night sleeps, and agent restarts.

Agent-portal connections

You can connect a terminal to a portal — an embedded browser living on the canvas. Once connected, the agent can control the browser programmatically: navigate pages, click elements, fill forms, take screenshots, read the DOM, and more.

No external dependencies or configuration — just connect and the agent gets full browser automation out of the box.

Note chaining

Notes can be connected to other notes, forming a chain (or tree). You only need to connect the entry-point note to the agent — the agent can then traverse the entire chain.

This creates a mind-map-like structure: you can organize information hierarchically across multiple notes, and the agent understands the hierarchy automatically.

Inspecting connections

Click the connections badge on a terminal (or any node with connections) to open the connections popover. Each row shows what's on the other end — another terminal, a note, a portal, or even a node on a different floor — and clicking the row pans the canvas to that element and selects it, switching floor if needed. The × button removes the connection without leaving the popover.