The CLI (mlcl)

The open-source Molecule.dev command line: scaffold, search packages, wire and swap capabilities, check env, and operate deployments.

Overview

Note

This is the docs reference. The mlcl page carries the full tour (install, quickstart, agent wiring, existing apps, package authors, FAQ) and the complete command map.

mlcl is the open-source (Apache-2.0) command line for Molecule.dev. It runs on Node 22+ and works without an account for everything local (scaffolding, searching packages, checking env); it logs in only when you want the cloud: deploy, sandboxes, teams.

npm install -g mlcl

Or run it without installing: prefix any command with npx and it works the same.

The everyday commands

CommandWhat it does
mlcl create <name>scaffold from a template or a custom stack
mlcl templatesbrowse the 100+ flagship apps
mlcl search <capability>find packages by what they do ("send emails")
mlcl add @molecule/<pkg> --injectinstall AND wire a package (bonds, migrations, routes)
mlcl swap @molecule/<provider>same interface, different vendor
mlcl env checkwhich env vars the app needs and which are missing
mlcl deploy --project <id> --followproduction deploy, the IDE pipeline
mlcl logs --project <id> --streamlive runtime logs
mlcl sandbox status --project <id>the project sandbox (+ start / stop / exec)
mlcl checkrun the project’s own typecheck / lint / build / tests
Tip

mlcl env check --fix writes the fixable missing vars into your .env for you.

Machine-readable output

Every command that prints a table takes --json, and every interactive prompt can be bypassed with --no-interactive. That is deliberate: the CLI is the same surface the MCP server exposes to coding agents, so scripts and agents get first-class output:

mlcl search "payments" --json | jq '.[].name'

Where nobody can approve a browser login (CI, cron, a remote agent), set MOLECULE_TOKEN to a personal API token instead of running mlcl login.

The full surface

This page is the short list. The mlcl page carries the full tour (agent wiring, existing apps, package authors, telemetry) and the complete command map; mlcl --help always tells the truth for your installed version.