Mprove
.mdx

Builder

Builder is a lightweight IDE section of Mprove UI.

Users with File Editor role can browse, edit and validate Mprove and Malloy files.

Mprove validates all files on each file save in UI.

After successful validation Mprove rebuilds consumable state of UI Models, Charts, Reports and Dashboards.

Editor AI Session

Editor AI Session can build Mprove models and create charts, reports and dashboards that are persisted as files (non-drafts).

Editor Session runs in a sandbox (E2B provider).

It is powered by open source OpenCode Server with default agents (build/plan + subagents). You can use your own Opencode config that is local to project.

AI agent uses mprove sync CLI command to sync uncommitted changes between sandbox repo and Mprove server.

Notes

Each Editor Session runs in its own sandbox.

It takes 10 to 15 seconds for session initial activation time (starting sandbox, pulling user project git repo and starting an Opencode server).

After session is activated, there is a safe pause logic in place to save sandbox resources when session is 5 min+ idle. To resume a paused session (sandbox) you need to send a new message. Unpause (resume) is fast. Session state is preserved on pause/resume.

Capabilities

  • Setup Mprove project
  • Add metadata to dwh schemas
  • Build Mprove models
  • Build charts (non-draft)
  • Build reports (non-draft)
  • Build dashboards (non-draft)

E2B Sandbox Template

Credentials

Credentials that are provided to sandbox during session activation:

  • LLM provider api key for selected session Model (see project settings API keys)
  • MPROVE_CLI_API_KEY (has access to mprove session repo branch and session env connections)
  • MPROVE_CLI_PROJECT_ID
  • MPROVE_CLI_HOST

Global Instructions

These global instructions are merged with your project's local instruction files. See Opencode Docs.

On this page