What Gets Created

Running mxcli init (or mxcli new, which runs init automatically) creates the following directory structure in your Mendix project.

Universal Files (All Tools)

These files are shared by all AI tools:

your-mendix-project/
├── AGENTS.md                          # Comprehensive AI assistant guide
├── .ai-context/
│   ├── skills/                        # MDL pattern guides
│   │   ├── write-microflows.md        # Microflow syntax and patterns
│   │   ├── create-page.md            # Page/widget syntax reference
│   │   ├── alter-page.md             # ALTER PAGE in-place modifications
│   │   ├── overview-pages.md         # CRUD page patterns
│   │   ├── master-detail-pages.md    # Master-detail page patterns
│   │   ├── generate-domain-model.md  # Entity/Association syntax
│   │   ├── check-syntax.md           # Pre-flight validation checklist
│   │   ├── organize-project.md       # Folders, MOVE, project structure
│   │   ├── manage-security.md        # Roles, access control, GRANT/REVOKE
│   │   ├── manage-navigation.md      # Navigation profiles, menus
│   │   ├── demo-data.md              # Database/import/demo data
│   │   ├── xpath-constraints.md      # XPath syntax in WHERE clauses
│   │   ├── database-connections.md   # External database connections
│   │   ├── test-microflows.md        # Test annotations and Docker setup
│   │   └── patterns-data-processing.md # Delta merge, batch processing
│   └── examples/                      # Example MDL scripts
├── mxcli                              # CLI executable (copied)
└── .devcontainer/                     # Dev container configuration
    ├── devcontainer.json
    └── Dockerfile

Tool-Specific Files

Claude Code

.claude/
├── settings.json          # Claude Code project settings
├── commands/              # Slash commands for Claude
│   └── mendix/           # Mendix-specific commands
├── lint-rules/            # Starlark lint rules
└── lint-config.yaml       # Lint settings (excluded modules, rule overrides)
CLAUDE.md                  # Project context for Claude

lint-config.yaml

Seeded with the System module excluded. System is Mendix’s own platform module — you cannot document its entities, give them access rules, or rename their members — so linting it produces findings you can never action. On a blank app that was the large majority of all issues.

mxcli init writes this file only when the project has no lint config yet (.claude/lint-config.yaml, lint-config.yaml, or .lint-config.yaml), so re-running init never discards your edits.

Add Marketplace modules (Atlas_Core, Administration, …) to excludeModules if their findings distract you — they are equally read-only in practice.

To lint System after all, remove it from excludeModules. Note the list always wins: it merges with --exclude, and a module listed there stays excluded even if you name it with --modules (lint warns when you try).

Cursor

.cursorrules               # Compact MDL reference and command guide

Continue.dev

.continue/
└── config.json            # Custom commands and slash commands

Windsurf

.windsurfrules             # MDL rules for Codeium's AI

Aider

.aider.conf.yml            # YAML configuration for Aider

Dev Container Contents

The .devcontainer/ provides a sandboxed environment with:

Key paths inside the container:

~/.mxcli/mxbuild/{version}/modeler/mx    # mx check / mx build
~/.mxcli/runtime/{version}/               # Mendix runtime (auto-downloaded)
./mxcli                                    # Project-local mxcli binary

Skills Overview

The skill files in .ai-context/skills/ teach AI assistants how to generate correct MDL. Each skill covers a specific topic:

AI assistants are instructed to read the relevant skill file before generating MDL for that topic.