Maestro for developers

Fully customize the way you work.

Maestro is built around your agents, your files and the way you work. Two kinds of extension let you shape it: custom panels add views beside your chats and code, and custom tools add functions your agents can call. Each is one file, written by you or your agent, running in a sandbox that sees only what you hand it.

  1. 01 Custom panels · Available in beta
  2. 02 Custom tools · Available in beta

01 · Available in beta

Custom panels

Custom panels let you add your own views to Maestro: a table for a CSV file, a viewer for your logs, a chart of your results. A panel is one HTML file. Install it, open it beside your chats and code, and it works with the files you choose. Custom panels are in beta.

Or have your agent build one. Tell it:

Read https://optimisticagency.com/docs/panels.md, then make me a Maestro panel that …

Three examples to start from

All three are in Maestro under + Panel → Manage panels…, and each is one file you can read and copy.

Table Lens running in a Maestro pane

01

Table Lens

Sort, filter and page through any CSV in your project. Each pane keeps its own file and view.

Chart Lens running in a Maestro pane

02

Chart Lens

Turn a column into bars, largest first: benchmark results, file sizes, latencies.

03

Unit Convert

A tool that needs only its input: convert takes a value, from and to units, and returns the result. Agents call it with no pane open.

The idea in one minute

  1. 01

    A panel is one HTML file.

    Its manifest, a small JSON block, sits inside the file. Write it by hand, ask an agent to write it, or build it with React or any web framework and bundle it into one file.

  2. 02

    You install it, or an agent makes it for you.

    It then appears in + Panel next to Chat, Editor, Terminal and the other built-in panels, in every project on your account, on the web and in the Maestro app.

  3. 03

    Every pane is its own copy.

    Open the same panel twice on two different files. Each pane remembers its file and its view in split panes, in floating windows and after a reload.

  4. 04

    It sees only what you hand it.

    You can choose a file in Maestro’s file finder, or an agent can bind an authorized file to the pane. The panel receives that file's name and contents, never its path or anything else in your project.

  5. 05

    It can't send your data anywhere.

    Panels run in a sandbox with no network, no access to your Maestro session, and no way to open pages or windows.

Two ways to make one

Write the file yourself or ask an agent in a Maestro chat, on the web or in the Maestro app on your phone.

Web

By hand, on the web

  1. In a Maestro project, open + Panel → Manage panels… and choose Copy starter panel.
  2. Save it as a file in your project, such as panels/my-panel.html. Give it your own id and name, and write the page.
  3. In Manage panels…, choose Install from a project file…, pick the file, then Install panel.
  4. Open it from + Panel. To change it, edit the file, raise its version and install it again.

Phone

By hand, on your phone

  1. Save the panel's file in your project, from the web or by asking an agent to write it.
  2. In the Maestro app, tap + → Custom panel → Manage panels…, then Install from a project file…, choose the file and tap Install panel. Examples install with one tap.
  3. Back in the chooser, tap the panel to open it.
  4. In a phone's browser, Maestro on the web has the same + → Custom panel chooser and the same Manage panels….

Web

With an agent, on the web

  1. In any Maestro chat, ask: “Make me a panel that …”.
  2. The agent asks first. Approve the Create panel card, and the panel appears in + Panel, marked Draft.
  3. Open it beside the chat, or let the agent open it. Its edits need no approval, and the pane redraws after each one.
  4. When you like it, Approve the Publish panel card, which lists each change in plain words. Draft goes away.
  5. If a later edit breaks it, choose Draft → Go back to published version.

Phone

With an agent, on your phone

  1. In a chat in the Maestro app, ask the same: “Make me a panel that …”.
  2. The Create panel and Publish panel cards appear in the chat. Tap Approve on each.
  3. The panel opens on your phone, not on a computer you left open. Draft sits in its top strip. Before the first publish it reads Not published yet; after it, it offers Go back to published version.

02 · Available in beta

Custom tools

Custom tools let an agent work with the views and functions you add to Maestro. For example, ask it to open a project CSV in Table Lens, filter to Shelf B and report the matching count. Maestro supplies the file to the pane, the panel applies its filter, and the result appears in your conversation. Tools live in the same HTML files as custom panels.

The idea in one minute

  1. 01

    A tool is a function your agent can call.

    Give it a name, description and input schema. Agents discover installed tools, read their schemas and call them through Maestro's shared extension tools.

  2. 02

    It runs in the same sandbox as a panel.

    One HTML file contains the manifest and handlers. It works on its input and, in an open pane, that pane's bound file and view state. Network access stays blocked.

  3. 03

    Panels can offer tools.

    An agent can open a panel, bind an authorized project file, apply a filter or change a chart, and report the result without a file picker.

  4. 04

    Every agent uses the same interface.

    API agents, Maestro CLI, Claude Code and Codex use the same discovery and call tools, and an agent you equip in Agent Studio calls a tool by name. Keep a Maestro window open (desktop, phone-width web or Maestro mobile) while tools run.

  5. 05

    You stay in charge.

    Manage panels shows declared tools before installation. Calls and results appear in the conversation. Turn an extension off or remove it there at any time.

Two ways to make one

Write the file yourself or ask an agent in a Maestro chat, on the web or in the Maestro app on your phone.

Web

By hand, on the web

  1. In a Maestro project, open + Panel → Manage panels… and choose Copy starter panel.
  2. Save it as a file in your project, such as panels/my-panel.html. Give it your own id and name, and write the page.
  3. In Manage panels…, choose Install from a project file…, pick the file, then Install panel.
  4. Open it from + Panel. To change it, edit the file, raise its version and install it again.

Phone

By hand, on your phone

  1. Save the panel's file in your project, from the web or by asking an agent to write it.
  2. In the Maestro app, tap + → Custom panel → Manage panels…, then Install from a project file…, choose the file and tap Install panel. Examples install with one tap.
  3. Back in the chooser, tap the panel to open it.
  4. In a phone's browser, Maestro on the web has the same + → Custom panel chooser and the same Manage panels….

Web

With an agent, on the web

  1. In any Maestro chat, ask: “Make me a panel that …”.
  2. The agent asks first. Approve the Create panel card, and the panel appears in + Panel, marked Draft.
  3. Open it beside the chat, or let the agent open it. Its edits need no approval, and the pane redraws after each one.
  4. When you like it, Approve the Publish panel card, which lists each change in plain words. Draft goes away.
  5. If a later edit breaks it, choose Draft → Go back to published version.

Phone

With an agent, on your phone

  1. In a chat in the Maestro app, ask the same: “Make me a panel that …”.
  2. The Create panel and Publish panel cards appear in the chat. Tap Approve on each.
  3. The panel opens on your phone, not on a computer you left open. Draft sits in its top strip. Before the first publish it reads Not published yet; after it, it offers Go back to published version.

Then

Maestro Store: coming soon

Soon you'll share panels and tools in a store for other people to install, with updates and removal handled for them, and later, paid ones. Publishing a panel in Maestro today only makes it the version to go back to; it does not list it anywhere. Until the store opens, share a panel by sending someone the file; they install it from their project.

Tell us what you'd build: hello@optimisticagency.com