You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add GitHub Copilot to supported AI tools across all docs
Copilot works out of the box via AGENTS.md with no dedicated --tool
flag, making it the easiest path for organizations on Microsoft
contracts. Added dedicated section in other-ai-tools.md and updated
all tool lists across README, site docs, and migration guide.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
>
5
5
> **Do not edit a project with mxcli while it is open in Studio Pro.** Studio Pro maintains in-memory caches that cannot be updated externally. Close the project in Studio Pro first, run mxcli, then re-open the project.
6
6
7
-
A command-line tool that enables AI coding assistants ([Claude Code](https://claude.ai/claude-code), OpenCode, Cursor, Continue.dev, Windsurf, Aider, and others) to read, understand, and modify Mendix application projects.
7
+
A command-line tool that enables AI coding assistants ([Claude Code](https://claude.ai/claude-code), GitHub Copilot, OpenCode, Cursor, Continue.dev, Windsurf, Aider, and others) to read, understand, and modify Mendix application projects.
8
8
9
9
**[Read the documentation](https://mendixlabs.github.io/mxcli/)** | **[Try it in the Playground](https://codespaces.new/mendixlabs/mxcli-playground)** -- no install needed, runs in your browser
10
10
@@ -13,7 +13,7 @@ A command-line tool that enables AI coding assistants ([Claude Code](https://cla
13
13
Mendix projects are stored in binary `.mpr` files that AI agents can't read directly. `mxcli` bridges this gap by providing:
14
14
15
15
-**MDL (Mendix Definition Language)** - A SQL-like syntax for querying and modifying Mendix models
16
-
-**Multi-tool support** - Works with Claude Code, Cursor, Continue.dev, Windsurf, Aider, and more
16
+
-**Multi-tool support** - Works with Claude Code, GitHub Copilot, OpenCode, Cursor, Continue.dev, Windsurf, Aider, and more
17
17
-**Full-text search** - Search across all strings, messages, and source definitions
18
18
-**Code navigation** - Find callers, callees, references, and impact analysis
19
19
-**Catalog queries** - SQL-based querying of project metadata
Copy file name to clipboardExpand all lines: docs-site/src/migration/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Migration Guide
2
2
3
-
mxcli and MDL enable AI-assisted migration of existing applications to the Mendix platform. An AI coding agent (Claude Code, Cursor, Windsurf) investigates the source application, maps its elements to Mendix concepts, generates MDL scripts, and validates the result -- all from the command line.
3
+
mxcli and MDL enable AI-assisted migration of existing applications to the Mendix platform. An AI coding agent (Claude Code, GitHub Copilot, OpenCode, Cursor, Windsurf) investigates the source application, maps its elements to Mendix concepts, generates MDL scripts, and validates the result -- all from the command line.
4
4
5
5
This part covers the five-phase migration workflow and the skills that support each phase.
Copy file name to clipboardExpand all lines: docs-site/src/preface/vision.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ mxcli and MDL exist to make Mendix development accessible to coding agents, auto
4
4
5
5
## Coding Agents First
6
6
7
-
The primary audience for mxcli is not a human typing commands -- it is a coding agent (Claude Code, Cursor, Windsurf, or similar) that reads, reasons about, and modifies Mendix projects autonomously. Everything in mxcli is designed with this in mind:
7
+
The primary audience for mxcli is not a human typing commands -- it is a coding agent (Claude Code, GitHub Copilot, OpenCode, Cursor, Windsurf, or similar) that reads, reasons about, and modifies Mendix projects autonomously. Everything in mxcli is designed with this in mind:
8
8
9
9
-**MDL as machine-readable output.** Every `DESCRIBE` command produces valid MDL that can be fed back as input. Agents can read a microflow, modify it, and write it back without lossy format conversions.
10
10
-**Skills and context files.**`mxcli init` generates structured skill files that teach agents MDL syntax, common patterns, and project conventions -- reducing hallucination and retry loops.
-**Linting and reports** -- 40+ built-in lint rules with SARIF output for CI; scored best-practices reports.
30
30
-**Testing** -- test microflows using MDL syntax with javadoc-style annotations.
31
-
-**AI assistant integration** -- works with Claude Code, Cursor, Continue.dev, Windsurf, and Aider. `mxcli init` sets up project configuration, skills, and a Dev Container for sandboxed AI development.
31
+
-**AI assistant integration** -- works with Claude Code, GitHub Copilot, OpenCode, Cursor, Continue.dev, Windsurf, and Aider. `mxcli init` sets up project configuration, skills, and a Dev Container for sandboxed AI development.
32
32
-**VS Code extension** -- syntax highlighting, diagnostics, code completion, hover, go-to-definition, and context menu commands for `.mdl` files.
33
33
-**External SQL** -- connect to PostgreSQL, Oracle, or SQL Server; query external databases; import data into a running Mendix application.
Copy file name to clipboardExpand all lines: docs-site/src/tutorial/claude-code.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -214,4 +214,4 @@ Claude validates the script, executes it, and reports back. You can then open th
214
214
215
215
## Next steps
216
216
217
-
If you use other AI tools alongside Claude Code, see [Cursor / Continue.dev / Windsurf](other-ai-tools.md). To understand how skills work in detail, see [Skills and CLAUDE.md](skills.md).
217
+
If you use other AI tools alongside Claude Code, see [Other AI tools](other-ai-tools.md) (GitHub Copilot, OpenCode, Cursor, Continue.dev, Windsurf). To understand how skills work in detail, see [Skills and CLAUDE.md](skills.md).
|**GitHub Copilot**|`AGENTS.md`| Reads universal context automatically via VS Code |
67
68
|**Cursor**|`.cursorrules`| Compact MDL reference and mxcli command guide |
68
69
|**Continue.dev**|`.continue/config.json`| Custom commands and slash commands |
69
70
|**Windsurf**|`.windsurfrules`| MDL rules for Codeium's AI |
@@ -79,6 +80,19 @@ OpenCode receives full integration on par with Claude Code: dedicated skills in
79
80
mxcli init --tool opencode /path/to/project
80
81
```
81
82
83
+
### GitHub Copilot
84
+
85
+
GitHub Copilot works with mxcli out of the box via the universal `AGENTS.md` file — no dedicated `--tool` flag is needed. Copilot's agent mode in VS Code automatically reads markdown files in the project root, so after running `mxcli init`, Copilot has access to the full MDL reference and skill files.
86
+
87
+
```bash
88
+
# Any mxcli init creates AGENTS.md, which Copilot reads automatically
89
+
mxcli init /path/to/project
90
+
```
91
+
92
+
For many organizations, Copilot is the default AI assistant as part of their Microsoft/GitHub enterprise agreement. mxcli supports this by ensuring the universal files (`AGENTS.md`, `.ai-context/skills/`) provide enough context for Copilot to work effectively with MDL.
93
+
94
+
To use: open the project in VS Code with the GitHub Copilot extension, open Copilot Chat (Ctrl+Shift+I), and ask for Mendix changes. Copilot will reference `AGENTS.md` and the skill files for MDL syntax guidance.
95
+
82
96
### Cursor
83
97
84
98
Cursor reads its instructions from `.cursorrules` in the project root. The file mxcli generates contains a compact MDL syntax reference and a list of mxcli commands the AI can use. Cursor's Composer and Chat features will reference this file automatically.
0 commit comments