@jem-open/mbali

The mbali command line — the front door to mbali, a reconciling control plane for fleets of remote AI agent sessions. You declare planes (work source → agent → channel) and mbali keeps the live sessions converged on what you asked for.

This package ships the vendor-neutral CLI and the defineMbaliCli config helper. The CLI knows nothing about any provider: doctor, simulate and runs operate purely through the ports your config wires up, so swapping a driver changes nothing here.

Install

pnpm add -D @jem-open/mbali        # CLI
pnpm add @jem-open/mbali-core      # the engine + ports your config wires up

Start a new project instead of wiring one by hand:

pnpm create @jem-open/mbali my-app

The mbali command

| Command | What it does | | --------------------- | --------------------------------------------------------------- | | mbali doctor | Run every wired driver's preflight health checks. | | mbali simulate <name> | POST a correctly-signed synthetic event from a wired ingress. | | mbali runs | List runs from the wired run store. |

All three read a config file (default mbali.config.ts, override with --config).

defineMbaliCli

Export a config that wires your drivers; the CLI discovers what it can do from it.

import { defineMbaliCli } from "@jem-open/mbali";

export default defineMbaliCli({
  baseUrl: process.env.HOST_URL,
  doctor: [slackIngress, runtime],   // anything HealthCheckable
  simulators: [slackSimulator],      // anything EventSimulator
  runStore,                          // any RunStore driver
});

See the examples for full configs.

Part of mbali — the control plane for fleets of remote AI agent sessions.