School of Maestria

Welcome to Maestri

This is Maestri.

It's an app for orchestrating artificial intelligence agents.

It lets you organize your agents, and the context around them, in a simple way, all on an infinite canvas. It gives you a broad view of everything that's happening, and lets you arrange things in whatever way makes the most sense to you.

There's no right or wrong way to use it, but the goal of this video is to walk you through your first steps, so you can start conducting your own orchestra.

Workspaces

Let's start with the interface. On the left, in this sidebar, are your workspaces. Think of workspaces as separate projects. Take Maestri itself: it has a marketing website, and an app for Mac, Windows, and Linux. Each of those parts could be its own workspace.

Let's create a workspace for the Maestri website. Besides the name, choose an icon and a color. Once you have lots of workspaces, this will help you find each one quickly in the sidebar.

Now, here's the important part: choose a folder on your computer. This is where your agents will start, and where your project will be developed. If you have a repository for this project, now's the time to select it.

Your first agent

Now, in our new workspace, let's create our first agent. But first, it's important to understand that Maestri doesn't come with AI agents. It expects you to already have them installed in your terminal. There are great options, like Claude Code and Codex, which work with your Claude and ChatGPT subscriptions. Follow the links in the description to install them.

To create our first agent, look at the top of the interface. This is the toolbar. We'll explore each tool, but for now, select the Terminal tool. To place a terminal on the canvas, click once where you want it, or click and drag to draw it at a specific size.

Maestri comes with presets for the most popular agents. So, to add a Claude terminal, just click the Claude Code button. Notice that this fills in a few fields in the form. The Command field is the most important one: it's what launches the installed agent. In Maestri's Settings, you can change this list of presets and commands. You can also set a name, and that will matter in a moment.

Moving around the canvas

The great thing about the canvas is that you have virtually unlimited space for your elements. But so you don't get lost, let's learn a few basic controls. To move the camera with a mouse, click and hold the middle button, the scroll wheel, and drag. On a trackpad, drag with two fingers in any direction.

To change the zoom, use the controls in the bottom right corner. Pinching on the trackpad, or holding Option while you scroll the mouse, works great too. Next to the zoom controls, there's a minimap that shows where you are on the canvas.

Prompt Composer and Chat

Maestri comes with a few features that improve the experience of using terminals. When a terminal is selected, a contextual toolbar appears with a few options. This button turns on the Prompt Composer: a powerful text field that gives you a better way to write prompts and attach files for your agent.

There's also Chat, which gives the terminal a graphical interface, for an experience like your favorite messaging apps.

Connecting agents

What makes Maestri powerful is that it lets your agents communicate and collaborate with each other. To do that, select a terminal, click the Connect button in the contextual toolbar, and then click the terminal you want to connect it to.

A cable appears on the canvas, showing the connection between them. In the contextual toolbar, a numbered badge appears, with the list of connections and a button to remove them. Once they're connected, type the at sign in the Prompt Composer, and the other agent shows up in the list of mentions. Give it a try: ask one to send a message to the other.

Notes and Fichários

Another important part of Maestri is notes. They look like sticky notes, but underneath, they're real markdown files saved on your computer. To create one, select the Note tool in the toolbar and click on the canvas. From the contextual toolbar, you can switch between Raw mode, where you write the markdown, and Formatted mode, which shows headings, tables, images, and even diagrams.

The best part is that you can connect a note to an agent, the same way we connected the terminals. From then on, the agent can read it and write to it. That makes notes a great place to keep your project's context: a to-do list, a spec, decisions you don't want to lose. And if several agents are connected to the same note, they all work from the same source.

When your notes start piling up, select two or more, right-click, and choose Place in Fichário. They become pages in a tabbed folder, and when you connect the Fichário to an agent, it can access all of them at once.

Portals

The toolbar also has the Portal, a browser that lives right on the canvas. Press the P key, type an address, and you're done. If you're running your project locally, you can open localhost right here, next to your agents.

And like everything in Maestri, portals can be connected too. An agent connected to a portal can navigate, click, type, and take screenshots of the page. In other words, it can see the result of what it just built and fix it on its own, without you having to describe the problem. And portals aren't just for websites. They can also run the iOS Simulator on a Mac, and Android emulators or phones, and your agents control them the same way: tapping, swiping, and testing the app they just built.

Roles

With more than one agent on the canvas, it makes sense for each one to have its own job. That's what roles are for: a set of instructions the agent receives automatically when it starts. One can be the developer, another the reviewer, another the tester. You create and edit roles in Settings, under Agents, and you can assign them when you create the terminal, or later, by right-clicking it.

Maestro Mode

And what if, instead of building the team yourself, you asked an agent to do it? That's Maestro Mode. Edit a terminal, check the Maestro option in the Details tab, and that agent can now create new agents on the canvas, give them roles, connect them to the right notes, and dismiss each one when its work is done.

Floors

With several agents working on the same project, sooner or later they'll end up editing the same files at the same time. Floors solve that. Remember the folder we chose at the beginning? If it's a git repository, each floor gets its own copy of it, on its own branch, with a separate canvas.

To create a floor, just ask your Maestro agent. In its Prompt Composer, type the at sign, choose New Floor, and describe the task. Maestri creates the floor, puts an agent on it, and the work begins, without getting in the way of what's already in progress. When the work is ready, you land the floor back on the Ground, with a local merge or by opening a pull request.

What's next

These are your first steps in Maestri. There's still a lot more to explore, like Routines and Partituras, and you'll find all of it in the documentation, linked in the description. Now it's your turn. Happy conducting.