Home / mendixlabs / mxcli · .claude/skills/mendix/run-local/SKILL.md · GitHub

run-local skillB

run-local is agent-read markdown (skill) from mendixlabs/mxcli: The warm Docker-free dev loop, `mxcli run --local` — model changes live in about a second, with watch, screenshots, metrics, tracing and external preview. Use for the fastest edit-to-running-app cycle, especially when driving the model programmatically with MDL..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Warm Local Dev Loop — `mxcli run --local`

## Overview

`mxcli run --local` runs a Mendix app **without Docker**, keeping a
`mxbuild --serve` process and a standalone runtime hot so model changes apply in
~1 s instead of a ~30–60 s rebuild-and-restart. Use it as the fast inner loop when
iterating on an app; use `mxcli docker run` when you need the fully-rendered browser
client (see the limitation below).

## When to Use This Skill

Use this when:
- You want the fastest edit → running-app loop for a Mendix 11.x project.
- You're driving the model programmatically (`mxcli exec`/MDL) and want each change
  live immediately.
- You're iterating on **page design** (the app renders in a real browser) or doing
  runtime/model/API/headless verification.

Prefer `mxcli docker run` when:
- The project is Mendix 9/10 (JDK 11/17 — not yet supported by `run --local`).
- You want a container-parity deployment rather than a standalone runtime.

## Usage

```bash
# boot once and keep serving (Ctrl-C to stop)
mxcli run --local -p app.mpr

# boot and hot-apply on every project change
mxcli run --local -p app.mpr --watch
```

## How apply is chosen
…

Read the whole file at its exact version.

How to install

Latest version
mdr add mendixlabs/mxcli/run-local@git:20260923.d73fc6d
Exact content
mdr add mendixlabs/mxcli/run-local@sha256:22e4715972aaa730

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_dq5za54hhqymikg4.svg)](https://markdownregistry.com/a/art_dq5za54hhqymikg4)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.d73fc6d latest2026-09-23 d73fc6d 35,726 BB view · diff
git:20260922.4954f842026-09-22 4954f84 35,571 BB view · diff
git:20260917.4992ee92026-09-17 4992ee9 30,126 BB view · diff
git:20260913.40b2ecd2026-09-13 40b2ecd 29,966 BB view · diff
git:20260830.9dcdc3f2026-08-30 9dcdc3f 29,512 BB view · diff
git:20260825.18b133a2026-08-25 18b133a 28,076 BB view · diff
git:20260821.ff81a242026-08-21 ff81a24 27,604 BB view

Audit of the latest version

B  16 of 17 checks passed. Deterministic, no model, same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (35726 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Source

GitHub

mendixlabs/mxcli · 124 stars · license Apache-2.0 · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dq5za54hhqymikg4
GET https://markdownregistry.com/api/v1/resolve?ref=mendixlabs/mxcli/run-local
GET https://markdownregistry.com/api/v1/blob/22e4715972aaa7308652ba8c7752580b38fc884eaf39c8ba0e5636062e1185c7

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from mendixlabs/mxcli

agents skill
mendixlabs/mxcli · .claude/skills/mendix/agents/SKILL.md · Author Mendix AI agent documents in MDL — Model, Knowledge Base, Consumed MCP Service and Agent, with variables, tools…
git:20260922.4954f84 · audit A · 124 stars
alter-page skill
mendixlabs/mxcli · .claude/skills/mendix/alter-page/SKILL.md · Modify an existing page or snippet's widget tree in place with ALTER PAGE / ALTER SNIPPET — SET, INSERT, DROP, REPLACE…
git:20260923.328828c · audit A · 124 stars
analyze-runtime skill
mendixlabs/mxcli · .claude/skills/mendix/analyze-runtime/SKILL.md · Find out what a running Mendix app actually does — logs, Prometheus metrics, OpenTelemetry traces and the model…
git:20260821.ff81a24 · audit B · 124 stars
assess-migration skill
mendixlabs/mxcli · .claude/skills/mendix/assess-migration/SKILL.md · Investigate an existing non-Mendix application (Java, .NET, Python, Node, PHP, …) and produce a structured migration…
git:20260821.ff81a24 · audit A · 124 stars
assess-quality skill
mendixlabs/mxcli · .claude/skills/mendix/assess-quality/SKILL.md · Audit a Mendix project against best practices for naming, security, performance, maintainability and architecture, and…
git:20260821.ff81a24 · audit A · 124 stars
atlas-design skill
mendixlabs/mxcli · .claude/skills/mendix/atlas-design/SKILL.md · Make a Mendix app look designed rather than default-Atlas: layout, spacing, typography, colour and design properties…
git:20260915.3d3ca1f · audit A · 124 stars
bootstrap-app skill
mendixlabs/mxcli · .claude/skills/mendix/bootstrap-app/SKILL.md · Provision a Mendix project in a repo that has none — interview, `mxcli new`, session hook, project brief, first commit…
git:20260922.98aa174 · audit A · 124 stars
browse-integrations skill
mendixlabs/mxcli · .claude/skills/mendix/browse-integrations/SKILL.md · Discover the external services a project consumes and browse their cached contracts through the MDL CATALOG — OData…
git:20260821.ff81a24 · audit A · 124 stars
bulk-widget-updates skill
mendixlabs/mxcli · .claude/skills/mendix/bulk-widget-updates/SKILL.md · Discover and bulk-change widget properties across many pages with SHOW WIDGETS and UPDATE WIDGETS. Use when the same…
git:20260821.ff81a24 · audit A · 124 stars
business-events skill
mendixlabs/mxcli · .claude/skills/mendix/business-events/SKILL.md · Define event-driven APIs over Kafka with Mendix business event services — publish and subscribe contracts…
git:20260821.ff81a24 · audit A · 124 stars
catalog-search skill
mendixlabs/mxcli · .claude/skills/mendix/catalog-search/SKILL.md · Search the Mendix Catalog platform service registry (catalog.mendix.com) from the CLI to find services published across…
git:20260821.ff81a24 · audit A · 124 stars
cheatsheet-errors skill
mendixlabs/mxcli · .claude/skills/mendix/cheatsheet-errors/SKILL.md · Quick fixes for the MDL syntax errors that come up most: undeclared variables, wrong retrieve source, list operations…
git:20260911.0d73eed · audit A · 124 stars

Every file in mendixlabs/mxcli

Browse by kind, by grade B, or by owner.