Our take
Newless than six months old- Activity
- 31
- Community
- 4
- Issues
- 21
- Pull requests
- 21
+0 stars in the last 17 days
- Fewer contributors than 91% of the projects we track
This is a narrowly focused, promising experiment for safe MDX-to-A2UI conversion, but its new age, lack of releases, and single-contributor history make it a prototype rather than a settled dependency.
Good fit if
- You are prototyping an agent workflow that needs MDX input and A2UI JSON output.
- Avoiding evaluation of generated MDX is important, and a closed component catalog suits your interface needs.
- You can work directly from the repository while the API and catalog remain experimental.
Look elsewhere if
- You need a stable, versioned package, since the project is not published to npm and has no release history yet.
- Your workflow needs arbitrary MDX components or executable expressions, which this parser deliberately does not support.
- You need evidence of sustained maintenance or issue resolution before adopting a dependency. The project has one contributor, no recent issue closures, and no merged pull requests in the measured period.
All health signals
| Last commit | 2026-08-16 (2 months ago) |
|---|---|
| Commits, last 90 days | 3 |
| Releases, last 12 months | 0 |
| Contributors | 1 |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 2 months |
Checked on 2026-10-20 with the GitHub API.
Overview
mdx-a2ui converts MDX, prose mixed with components from a closed catalog, into A2UI JSON. It addresses a tradeoff for agent-authored interfaces: MDX is a compact authoring format, while A2UI provides a structured output for renderers and clients beyond web browsers. The converter parses JSX instead of compiling or evaluating it, and accepts attribute expressions only when they parse as JSON literals.
The project is explicitly experimental, targets A2UI v0.9, and is not published to npm. Its intended users are developers building agent workflows that need to turn generated interface descriptions into A2UI data without running generated MDX code.
Key Features
- Converts MDX prose and approved components into A2UI JSON.
- Uses a closed component catalog rather than accepting arbitrary JSX components.
- Parses source without evaluating MDX, avoiding execution of generated code.
- Accepts attribute expressions only when they parse as JSON literals.
- Includes a repair step for MDX that is still streaming before conversion.
- Produces A2UI output for use with compatible renderers.
- Marks its exports with an
experimental_prefix to signal the unstable API.
Use Cases
- An agent-platform developer can author compact MDX prompts and convert completed responses into structured A2UI data.
- A team streaming model output can repair incomplete MDX before converting it into an interface representation.
- Developers who need A2UI output for clients beyond a browser can use MDX as the authoring surface while retaining the structured target format.
- A security-conscious prototype can parse agent-generated UI descriptions without evaluating them as code.
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
The repository does not provide an installation command in its README. Review the README and source before integrating it.
Considerations
The project is new and experimental: its exports, component catalog, and A2UI target may change, and there are no releases to pin. Recent activity is limited, and development is concentrated in one contributor; the measured period also shows no issue closures or merged pull requests. The README does not describe tests or CI, so teams should verify behavior against their own MDX and A2UI requirements. The repository is MIT-licensed, but the README does not document a stable package or installation workflow.
Found this useful?
Share it with someone who would like mdx-a2ui.