create-mdan

create-mdan scaffolds a minimal MDAN agent app or skills app that uses the public @mdanai/sdk root API and the app-facing host convenience.

Generated starters already follow the current default path:

• Markdown is the public read surface
• each page keeps an adjacent .action.json manifest
• actions submit JSON and return updated Markdown surfaces
• the app code uses createApp, page, route, action, and page.bind(...)

Usage

Node starter:

npm create mdan@latest agent-app
cd agent-app
npm install
npm start

Bun starter:

bunx create-mdan agent-app
cd agent-app
bun install
bun start

Choose the runtime explicitly:

npm create mdan@latest agent-app -- --runtime bun
bunx create-mdan agent-app --runtime node

What You Get

The generated project includes:

• a Markdown-first starter page
• an explicit app/index.action.json manifest
• a simple write action
• Node or Bun hosting
• @mdanai/sdk pinned to the compatible minor line

The generated project uses public SDK entry points only:

• @mdanai/sdk for app authoring
• app.host("node" | "bun", options?) for host integration
• @mdanai/sdk/core for the shared protocol/content layer when needed

Next Step

After scaffolding:

• open http://127.0.0.1:4321/
• edit app/index.md
• edit app/index.action.json
• run curl -H 'Accept: text/markdown' http://127.0.0.1:4321/index.md